home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / paket51.zip / MANUAL2@.EXE / MANUAL2.DOC < prev   
Text File  |  1992-04-06  |  224KB  |  6,573 lines
  1. PART V - Messages in the paKet system
  2. Overview
  3.  
  4.  This is a list of messages in the paKet system. They are listed in
  5.  alphabetic order. For the Online Manual, this Section has been divided
  6.  into several sub sections to  make it all a bit easier to manage.
  7.  
  8.  Each message is categorised with one of the following codes:
  9.  
  10.   I - Information level
  11.   W - Warning level
  12.   E - Error level
  13.   C - Errors with "Press Enter to Continue"
  14.   D - Dialogue (always appear regardless of level set)
  15.  
  16.   Information level messages are routine messages that do not require any
  17.   action on your part.
  18.  
  19.   Warning level messages are usually some more serious or unexpected event
  20.   but one that paKet can cope with.
  21.  
  22.   Errors are serious problems that you really should know about!
  23.  
  24.   Most messages will stay on the screen for about 3 seconds but those
  25.   which either require some action on your part or which might take a
  26.   little longer to digest will appear as 'C' type messages. For these, you
  27.   press the <Enter> key when ready to continue.
  28.  
  29.   You may choose to hide the Information level messages once you have had
  30.   some experience with the paKet system. The 3 second "delay" could become
  31.   tiring for those routine Information messages that you know about and
  32.   expect anyway.  You could even hide the Warning messages if you choose
  33.   but I would not recommend it!    Refer to the Configuration -
  34.   Miscellaneous options section for details on setting the Message Level.
  35.  
  36.   The Dialogue messages are those that require some data input, for
  37.   example where you are asked to enter a file name.
  38.  
  39.   Messages emanating from the Contest Mode have not been included here.
  40.   These messages apply only to that rather unique and seldom used sub
  41.   system. They are quite self explanatory if you are using that mode, but
  42.   would require some understanding of the Contest Mode to make much sense.
  43.   I have decided to omit them here to help reduce confusion.
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                Page  91
  62.  
  63. A to C
  64.  
  65.  W. A smaller version of this file exists.
  66.     I will attempt a paKet-Protocol Recovery
  67.  
  68.     This message could appear if a Binary File is being transferred to our
  69.     system and both stations are equipped to handle the advanced paKet
  70.     Protocol.
  71.  
  72.     The situation that causes this message is where the file being
  73.     transferred already exists on our system but our file is shorter than
  74.     the one about to be sent by the other station.   This could happen if
  75.     an earlier file transfer was aborted for some reason and so our file
  76.     would be incomplete.
  77.  
  78.     This message informs you that paKet is asking the other station to
  79.     check the details to see if a Recovery is possible.
  80.  
  81.  
  82.  D. Abort, Retry, Ignore <R>
  83.  
  84.     An error has occurred. You have three options: A, R or I...
  85.  
  86.     A(bort) the program. If you select this option, paKet will simply give
  87.       up, and return to DOS. As this is a rather serious step, paKet will
  88.       seek your confirmation that this is really what you want to do by
  89.       prompting you with the following question:
  90.  
  91.          Aborting paKet and returning to DOS...  Are you sure? <N>
  92.  
  93.       If you then reply "Y", everything stops and you will be returned to
  94.       the DOS Prompt.  It is nice to have a way out in case of a really
  95.       serious problem but I expect this option would be rarely required.
  96.  
  97.     R(etry) the operation that caused the error. This is the default
  98.       response so if you simply press <Enter>, paKet will assume a Retry.
  99.       In most cases I hope this will get you going again. For example it
  100.       might be a diskette problem such as "door not closed", "write
  101.       protect tab", etc so you can attend to the problem, select Retry and
  102.       things should proceed normally.
  103.  
  104.     I(gnore) the problem.  An error message is like pain: it is there for
  105.       a reason and should not be ignored. But if you are sure you know
  106.       what the problem is and choose to ignore it, you can select this
  107.       option and paKet will try to continue despite the error. However, do
  108.       this at your own peril and don't call me if you get into trouble!
  109.  
  110.  
  111.  I. Appending to existing file ..."
  112.  
  113.     This message appears when you are starting the Log file or are writing
  114.     the Flashback buffer to disk if paKet finds the specified file is
  115.     already on the disk.
  116.  
  117.     paKet will preserve the contents of that file and will write the new
  118.     data to the end of this file.
  119.  
  120.     No action required.
  121.  
  122.  
  123.                                Page  92
  124.  
  125.  E. ASCII file command must be AD, AC or AU
  126.  
  127.     The Script file you have just loaded contains a command beginning with
  128.     A but it is not one of the valid ASCII file transfer commands.
  129.  
  130.     The Script has been aborted.
  131.  
  132.  
  133.  D. Buffer Search
  134.     Please enter the search string  -
  135.  
  136.     When you wish to search backwards through the Flashback buffer for a
  137.     particular string of characters, this message will prompt you for the
  138.     data to search for.
  139.  
  140.     This is not case sensitive so it doesn't matter if the data is in
  141.     upper or lower case, if it is spelt the same it will be matched!
  142.  
  143.     Refer to the section on the <Alt-F> and <Alt-L> keys for further
  144.     discussion on this faciity.
  145.  
  146.  
  147.  E. CFG file error
  148.  
  149.     This error will appear immediately after you attempt to start the
  150.     program if there is something wrong with the PAKET.CFG file. It will
  151.     not even appear in a pop-up window because those windows will not have
  152.     been created yet.
  153.  
  154.     The error could be caused by an old version of the CFG file still in
  155.     the current directory. To run paKet version 5, you need a CFG file for
  156.     version 5 - it is not the same CFG file as that used in earlier
  157.     versions.
  158.  
  159.     If you do not have a CFG file for version 5 or if it has been
  160.     corrupted in some way you should either restore a backup copy of the
  161.     CFG file (if there is a PAKETCFG.BAK file available, try that) or
  162.     reinstall paKet version 5.
  163.  
  164.  
  165.  I. Clearing TNC's XOFF
  166.  
  167.     This message appears in response to your <Alt-Q> command to manually
  168.     override and reset the system's XOFF condition. This would be used
  169.     only if you are using Software Handshaking and then it would be a rare
  170.     occasion indeed that you might need this command.
  171.  
  172.     Refer to the <Alt-Q> command in the Special Keys section of this
  173.     Manual for more information on this command.
  174.  
  175.     If, after the XOFF condition is cleared, the TNC is still unable to
  176.     accept any more data, it will send another <XOFF> and paKet will
  177.     reenter the XOFF state.
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.                                Page  93
  186.  
  187.  I. Closing log file (filename)
  188.  
  189.     This is a message to confirm the Log File is now being closed.
  190.  
  191.     This message could appear after you close the Log File with the <F2>
  192.     key or  if the file is closed automatically by the AUTO log function
  193.     when a station is Disconnected.
  194.  
  195.     No action is required unless you want to continue logging, in which
  196.     case you should manually reactivate the Log File with the <F2> key.
  197.  
  198.  
  199.  D. COMx is not installed. Try another? (Y/N)
  200.  
  201.     When paKet starts, one of the first things it does is to set up the
  202.     Computer's Serial port. It tries to initialise the port you have
  203.     specified in your Configuration but if that port is unavailable, this
  204.     message appears to give you the opportunity to try another one.
  205.  
  206.     This condition should rarely occur but is possible if you have changed
  207.     your Computer's hardware or if you have copied a Configuration File
  208.     from another system.
  209.  
  210.     Anyway, no harm is done as paKet will cycle through all the Serial
  211.     Ports until it finds the one you wish to use.
  212.  
  213.     You should check the rest of the Configuration, especially the Serial
  214.     Port details once the system starts up.  If the Port number was wrong,
  215.     it is possible other parameters will need adjustment too.
  216.  
  217.  
  218.  W. Confirming...Connected to (callsign)
  219.  
  220.     After pressing <Alt-V> to verify the connected status, this message
  221.     will appear if the TNC agrees with the callsign already displayed in
  222.     the Communications Window Header line.
  223.  
  224.     No action required.
  225.  
  226.  
  227.  W. Confirming...Not Connected
  228.  
  229.     After pressing <Alt-V> to verify the connected status, this message
  230.     will appear if there is currently no connection and the TNC has simply
  231.     confirmed this.
  232.  
  233.     No action required.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                Page  94
  248.  
  249. D to H
  250.  
  251.  D. Deleting (filename) - Are you sure? (Y/N)
  252.  
  253.     If you attempt to delete a file, paKet will ask for confirmation
  254.     before it performs the deletion. You have one final chance!
  255.  
  256.     Enter "Y" to carry out the deletion.
  257.  
  258.  
  259.  E. Disk error on drive X
  260.  
  261.     Unfortunately this means just what it says.
  262.  
  263.     This error condition is returned by the DOS operating system. The
  264.     causes are many and varied so you should perform the usual checks to
  265.     try to identify the cause.  Typically the error is related to the lack
  266.     of space on a disk or diskette, or perhaps a diskette drive door was
  267.     opened.
  268.  
  269.     If there really is a fault with the disk you will be getting similar
  270.     error messages when you are running other programs. In that case
  271.     specialist attention is required.
  272.  
  273.     Refer to the I/O Error message for some of the types of error that may
  274.     be identified. This added information is supplied by DOS so check the
  275.     DOS documentation for further information.
  276.  
  277.     Refer to the description on the "Abort, Retry, Ignore" message for
  278.     discussion on the options available.
  279.  
  280.  
  281.  W. Displayed Callsign changed to match the TNC
  282.  
  283.     After pressing <Alt-V> to verify the connected status, this message
  284.     will appear if the TNC indicates we are connected to a station other
  285.     than that indicated in the current window's Communications Window
  286.     Header.
  287.  
  288.     No action required.
  289.  
  290.  
  291.  D. Enter a DOS command, or press Enter for a DOS window.
  292.     >
  293.  
  294.     When you want to exit to DOS to perform some program or DOS command
  295.     you can do it in one of two ways:
  296.  
  297.      1.  You may enter the command into the message window beside the
  298.          ">" prompt.
  299.  
  300.          If you do this, the command will be executed (if possible) and
  301.          you will be invited to "Press any key to continue" before paKet
  302.          resumes where it left off.  The "Press any key to continue"
  303.          message appears briefly over the DOS display to allow you time to
  304.          peruse the result of the job and to read any messages etc that
  305.          may have come from the DOS command.
  306.  
  307.       2. Press <Enter> instead of entering a command, and the screen will
  308.          be cleared before control is passed over to DOS and the familiar
  309.                                Page  95
  310.  
  311.          DOS Prompt.
  312.  
  313.          When you have finished the DOS operations, type EXIT to return to
  314.          paKet.  Do NOT type PAKET again as the system will attempt to
  315.          load a second copy of paKet into memory!
  316.  
  317.     Please keep in mind that paKet is still in memory at this stage,
  318.     gathering any incoming data that may be sent from the TNC while you
  319.     are doing your DOS jobs. So you will have considerably less free
  320.     memory for your other DOS programs and may even find some will not run
  321.     due to insufficient memory. The only remedy for this, I am afraid, is
  322.     to return to paKet and exit the program so you can release the memory
  323.     occupied by paKet.
  324.  
  325.  
  326.  D. Enter new Path\Filename for (filename)
  327.  
  328.     When you select a file to be Renamed or Moved to another directory
  329.     (with the <Alt-R> key), paKet will ask for the new name.
  330.  
  331.     In response to this message, enter the new filename or, if you wish to
  332.     move it to another sub directory, enter the full path details. For
  333.     example:
  334.        \PAKET\BINARY\UTILS\USEFUL.COM
  335.  
  336.     If the Rename or Move cannot be performed you might see one of the
  337.     following self explanatory messages:
  338.        No such file or directory
  339.        I can't do that.
  340.        Maybe that file exists?
  341.        I can't MOVE to a different device!
  342.  
  343.  D. Enter Path:
  344.  
  345.     When you choose to "Enter file name manually" from the Directory
  346.     Window you will be asked to enter the details in this Message Window.
  347.  
  348.     Any valid file name may be entered here, including a drive and/or
  349.     directory together with the desired filename.
  350.  
  351.  
  352.  E. Error closing the log file
  353.  
  354.     The operating system has detected an error while trying to close the
  355.     Log File.
  356.  
  357.     Check the usual things (available space, diskette drive, etc) and be
  358.     warned that you could have lost some of the log file with this error.
  359.  
  360.     Processing will continue without the Log File.
  361.  
  362.  
  363.  C. Error saving Configuration. No changes saved.
  364.  
  365.     If you make any changes to paKet's Configuration, the changes are
  366.     automatically saved to disk, but if this message occurs, the latest
  367.     changes to the Configuration have NOT been saved.
  368.  
  369.     Processing continues, but you should check your system to see why the
  370.     error occurred. The possible causes are many and varied but if you are
  371.                                Page  96
  372.  
  373.     not having other problems this could be as simple as running out of
  374.     space.
  375.  
  376.  
  377.  E. Error setting new directory
  378.  
  379.     When the Directory Window is on the screen, you may change directories
  380.     by highlighting a sub directory entry (shown as "<DIR>") then pressing
  381.     <Enter>. The system will change to that directory and will then
  382.     display the contents of that new sub directory.
  383.  
  384.     This error message occurs when the system is unable to change to the
  385.     new directory. As you would usually be changing by pointing to the
  386.     displayed directories, this error is most likely to be some sort of
  387.     disk or diskette error,
  388.  
  389.  
  390.  E. Error writing to file being Received - now closed
  391.  
  392.     A disk write error has occurred while receiving an ASCII file.
  393.  
  394.     The file is now closed but is probably incomplete. You should check
  395.     your computer system to see what might have caused the problem.
  396.  
  397.     Typically this error is caused by a lack of space on the disk or, if a
  398.     diskette is being used, check the diskette is not write protected and
  399.     the drive door is closed.
  400.  
  401.     When you have corrected the problem, you can try the file transfer
  402.     again.
  403.  
  404.  
  405.  D. EXIT to DOS?
  406.     Press "Y" to Confirm
  407.  
  408.     After pressing <Alt-X> to exit the program this message will appear
  409.     asking for your confirmation that this is what you really want. It is
  410.     so easy to press the wrong key (I have done it often).
  411.  
  412.     If you enter "Y" the paKet program will close down and control returns
  413.     to the DOS prompt (or to the Menu if you loaded paKet from a Menu).
  414.  
  415.     Anything else and paKet resumes whatever it was doing when you pressed
  416.     <Alt-X>.
  417.  
  418.  
  419.  C. Failed to make window
  420.  
  421.     There are over 20 different windows used by the paKet system and there
  422.     is some memory allocation and initialisation required to set these up.
  423.     The most likely problem if this message appears is Insufficient Memory.
  424.  
  425.     Refer to the Insufficient Memory message for further information.
  426.  
  427.  
  428.  E. File has no data
  429.  
  430.     You have selected a file to be sent to another station but this file
  431.     is empty!
  432.  
  433.                                Page  97
  434.  
  435.  E. File write error
  436.  
  437.     While performing a Binary File transfer a disk error has occurred. As
  438.     various checks are usually performed before the transfer begins, I am
  439.     afraid this message does suggest you have a hardware problem.
  440.  
  441.     Maybe if you are using diskettes the problem is simply a matter of the
  442.     drive door being open?
  443.  
  444.  
  445.  E. Hey, we have got more data than the file size expected!
  446.     I can't handle that, so I will abort the transfer
  447.  
  448.     This should not happen because the system will be expecting the exact
  449.     file size as indicated in the directory. But just in case...
  450.  
  451.     The problem could happen if you try to send a file that is currently
  452.     open and being used for something else. For example if you try to send
  453.     the Log File that paKet is currently using. But you wouldn't do that
  454.     would you?
  455.  
  456.  
  457.  I. Housekeeping...tidying up the PMS DataBase...
  458.  
  459.     From time to time, when you are using the Sysop PMS Menu (refer the
  460.     <Alt-M> key) paKet will perform some internal housekeeping to minimise
  461.     any wastage of space in the PMS sub-system. This message appears
  462.     briefly to inform you of this housekeeping.
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.                                Page  98
  496.  
  497. I can't...
  498.  
  499.  E. I can't append to the file
  500.  
  501.     A disk error has occurred after choosing to append to the existing
  502.     file. At this stage, we know the file exists so the most likely cause
  503.     would be a lack of space or a genuine hardware error. I hope you are
  504.     out of space!
  505.  
  506.  
  507.  E. I can't create a new PMS DataBase
  508.     I'll try again next time.
  509.  
  510.     While doing some housekeeping on the PMS DataBase, paKet tried to
  511.     create a new file to contain the "cleaned up" PMS but got a disk
  512.     error.
  513.  
  514.     This housekeeping can wait till next time - it is not critical - so
  515.     processing continues. You should check it out as soon as possible to
  516.     see what the problem is.
  517.  
  518.  
  519.  E. I can't create the file
  520.  
  521.     An attempt was made to create a new data file but it failed.
  522.  
  523.     You could check to see there is sufficient space available and if you
  524.     are using the Root directory, ensure there are sufficient directory
  525.     entries available.
  526.  
  527.     If using diskette, ensure the diskette is not write protected and the
  528.     diskette is inserted in the drive with the door closed.
  529.  
  530.     It should be quite obvious which file paKet is trying to create
  531.     because of other messages that will be displayed and because it is
  532.     probably the result of some command you have given that the file is
  533.     being created anyway.
  534.  
  535.     If the new file is one specified in the Configuration, for example the
  536.     Connect File, check the details in the Configuration - it may be you
  537.     have specified a drive or directory that does not exist.
  538.  
  539.  
  540.  E. I can't delete this entry
  541.  
  542.     You may delete a normal FILE from a Directory Window, but you may NOT
  543.     delete a ReadOnly, Hidden or System File, a Sub Directory, nor a
  544.     Volume Label!
  545.  
  546.  
  547.  C. I can't do that. Maybe that file exists?
  548.  
  549.     The system returned an error condition when trying to rename a file.
  550.  
  551.     Typically this could be because the new name you gave is a file that
  552.     already exists in that directory.  The Rename/Move function is not
  553.     like a COPY command - it will not overwrite an existing file.
  554.  
  555.  
  556.  
  557.                                Page  99
  558.  
  559.  E. I can't find COMMAND.COM
  560.  
  561.     You are in big trouble!  The system could not find COMMAND.COM and you
  562.     will not be able to run other DOS jobs without it!
  563.  
  564.     Usually DOS can find it via the COMSPEC parameter, or maybe in the
  565.     current directory or via the PATH statement.
  566.  
  567.  
  568.  W. I can't find (filename). I'll create a new one.
  569.  
  570.     When you first use the <Alt-C> facility to Connect to another station,
  571.     paKet will fail to find a Connect File and will produce this message
  572.     to let you know it is creating a new one.
  573.  
  574.     You can enter as many station details as you wish into this window and
  575.     it will be automatically saved to disk using the "filename" specified.
  576.     Next time that file should be found and the message will no longer
  577.     appear.
  578.  
  579.     There is a possibility the filename is incorrect in paKet's
  580.     Configuration in which case the message will serve as a warning that
  581.     you are not accessing the correct file. Or perhaps the file is on
  582.     diskette and the appropriate diskette is not in the drive. If so, you
  583.     can delete or ignore the new file just created, and insert the correct
  584.     diskette.
  585.  
  586.  
  587.  E. I can't find (filename)
  588.  
  589.     This error message appears after paKet is asked to process this data
  590.     file but the file could not be found.
  591.  
  592.     It is most likely to appear after you have manually entered a file
  593.     name.
  594.  
  595.     Try the operation again, specifying the correct file name, not
  596.     forgetting to specify a path (drive and subdirectory) if necessary.
  597.  
  598.     The error could also appear after selecting a file which is specified
  599.     incorrectly in the Configuration. For example if the location of the
  600.     TNC Help file is not correctly recorded in the Configuration this
  601.     message will appear when you press <F10> to see the TNC Help file. In
  602.     this case, select the Configuration (<Alt-Z>, then 8) and make the
  603.     necessary corrections before trying the operation again.
  604.  
  605.     If you are in REMOTE Mode and the other station requests a file
  606.     transfer, this message will be sent to that other station if the
  607.     specified file could not be found.
  608.  
  609.  
  610.  E. I can't find that message!
  611.  
  612.     You have entered a PMS command but the message number you have
  613.     specified does not exist.
  614.  
  615.     Reenter the command with the correct message number. You could perform
  616.     a List command ("L") to see the available messages.
  617.  
  618.  
  619.                                Page 100
  620.  
  621.  E. I can't find the (dir) directory.
  622.  
  623.     This message will appear if you have manually entered a file name and
  624.     path but the directory could not be found.
  625.  
  626.     Try the operation again with the correct name.
  627.  
  628.  
  629.  E. I can't find the program to run
  630.  
  631.     The "program" in this case could be a program name you have entered at
  632.     the DOS command line provided by paKet's <F9> DOS exit.
  633.  
  634.     Another possibility is the system could not find the program to Edit
  635.     or to Display a data file if you have used the <Alt-E> or the <Alt-D>
  636.     commands.
  637.  
  638.     If the message occurs after you select <Alt-E>, check paKet's Online
  639.     Configuration - Files/Directories and correct the System Editor entry
  640.     before trying the operation again.
  641.  
  642.     If the message occurs after you select <Alt-D>, check paKet's Online
  643.     Configuration - Files/Directories and correct the "Command to list a
  644.     file" entry before trying the operation again.
  645.  
  646.  
  647.  E. I can't MOVE to a different device!
  648.  
  649.     When moving a file with the <Alt-R> key, the system will not actually
  650.     copy the data, it simply adjusts the directory entry.  As different
  651.     drives have different directories, a "move" is not possible between
  652.     drives. You will have to copy the file to the new drive then (if
  653.     desired) delete the file on the original drive. Use the COPY command
  654.     from the DOS Gateway (refer <F9> key).
  655.  
  656.  
  657.  E. I can't Rename/Move this entry
  658.  
  659.     You may Rename or Move a normal FILE in a Directory Window, but you
  660.     may NOT Rename or Move a Hidden or System File, a Sub Directory, nor a
  661.     Volume Label!
  662.  
  663.  
  664.  D. I can't see CTS signal on the Serial Port!
  665.     Would you like to try Software Handshaking? (Y/N)
  666.  
  667.     You might need to refer to the discussion on Hardware vs Software
  668.     Handshaking in the Technical Section of this Manual if you have
  669.     difficulty understanding what this is all about.
  670.  
  671.     If you are using Hardware Handshaking the CTS signal should be present
  672.     when the program starts but paKet has found that signal "missing".
  673.  
  674.     It is possible the cable used to connect the TNC to the Computer does
  675.     not have this CTS line connected. Such cables are quite common and if
  676.     you have one of these, you must change to Software Handshaking.
  677.  
  678.  
  679.  
  680.  
  681.                                Page 101
  682.  
  683.     If you reply "Y" paKet will change it's Configuration to Software
  684.     Handshaking and processing will continue. Please ensure the TNC's
  685.     XFLOW command is set ON if you use Software Handshaking - this is
  686.     especially important if you are doing any file transfers.
  687.  
  688.     If you reply "N" paKet will attempt to continue in Hardware
  689.     Handshaking mode, although without a CTS signal it will be unable to
  690.     send to the TNC!   Usually you would select this option after you have
  691.     been able to restore the CTS line and then processing will continue
  692.     normally.
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.  
  703.  
  704.  
  705.  
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.                                Page 102
  744.  
  745. I to L
  746.  
  747.  E. I did not get the expected response from the TNC
  748.     So, I am not too sure whether we are connected or not!
  749.  
  750.     When you press <Alt-V> to verify the TNC's connected status. paKet
  751.     issues a command to the TNC and interrogates its response but in this
  752.     case the expected response was not received.
  753.  
  754.     The displayed callsign is not changed.
  755.  
  756.     If this happens more than once, it may be the TNC is not responding
  757.     for some reason so you should check that and ensure it is still
  758.     working for normal commands, then try the <Alt-V> again.
  759.  
  760.  
  761.  E. I don't have room for all the help file
  762.  
  763.     This error message means there are more index entries in the file than
  764.     I have allowed for.
  765.  
  766.     It is unlikely you will see this message, but if you do it is because
  767.     someone has modified the Help file since I released it.  Naughty!
  768.  
  769.  
  770.  C. Insufficient memory
  771.  
  772.     There are thousands of places within paKet (well quite a few anyway)
  773.     that could issue this dreaded message.
  774.  
  775.     Earlier versions of paKet had a separate message from each routine
  776.     that wanted some more memory but couldn't get it. This is nice, but
  777.     contributes to the problem as each of these separate messages occupy
  778.     some memory!  While there are a couple of situations where the system
  779.     can continue despite the lack of memory, in most cases paKet will
  780.     refuse to continue!   So, it doesn't really matter which part of paKet
  781.     wants the extra memory, you've still got the problem.
  782.  
  783.     paKet will perform some internal overlays to reduce the demands but
  784.     will still require a system with 384KB at a pinch, and preferably more
  785.     for a workable system.
  786.  
  787.     In addition to the program itself, memory is required for data storage
  788.     and buffers. Most of this storage is dynamically allocated from free
  789.     memory after the program is loaded and it is in this area that you
  790.     will most likely strike the "Insufficient memory" message. Examples
  791.     include allocation of memory for the data input buffers, and for the
  792.     Flashback buffers. You can configure up to 10 windows each of which
  793.     can have up to 32 KB for input buffer and up to 64KB Flashback buffer.
  794.     Try getting all that into 384KB, in fact try getting it all into 640KB!
  795.  
  796.     If you have any EMS memory available, paKet will automatically detect
  797.     it and will use some of that for its internal overlays, but most of
  798.     the memory required comes from the Base 640KB.
  799.  
  800.     Try to conserve as much memory as possible because even if paKet runs
  801.     quite happily in the available memory, you might still need more if
  802.     you want to run some external program from within paKet. For example,
  803.     editing a file will add to the memory demands as the system will have
  804.     to load the chosen Editor program then load the data file you want to
  805.                                Page 103
  806.  
  807.     edit. Or if you take the DOS exit (refer <F9> key) you might find
  808.     there is not enough memory left, after paKet has taken its lot, to run
  809.     your DOS commands.
  810.  
  811.     There are some things you can do to overcome this "Insufficient
  812.     memory" problem:
  813.  
  814.       1. If you are one of the few remaining diehards who are running an
  815.          IBM or compatible system with less than 640KB RAM, then the
  816.          solution is easy: "buy some more memory!"
  817.  
  818.       2. Reduce the memory demands from within paKet by:
  819.             a. configuring fewer Communications Windows (I find 3 plenty
  820.                for my operation). Each of these will consume some memory
  821.                overheads and if you don't really need all 10 windows you
  822.                can save some memory by reducing the number.
  823.  
  824.             b. configuring smaller buffers for Input and Flashback buffers
  825.                in each of the Communication Windows.
  826.  
  827.                Most of the time I use only the first window - it is only
  828.                on relatively rare occasions the second window gets used,
  829.                the third window hardly ever. So I tend to configure larger
  830.                buffers for the first window and reduce the others.
  831.  
  832.       3. Reduce other memory overheads such as TSRs.
  833.          Many people do not realise that Menu programs, Shells, and the
  834.          like that provide a "launching pad" for their programs, usually
  835.          remain in memory while their other program is running. You should
  836.          run paKet from the DOS prompt, by all means from a BATch file,
  837.          but not from a Shell or Menu.
  838.  
  839.          And any other TSRs such as DOS's Print Spooler, Mouse drivers,
  840.          various Pop-Up utilities such as Calendars and Phone Diallers,
  841.          all consume some memory even if they are not currently being
  842.          used. There are techniques available for some systems now to load
  843.          these things in High Memory (eg the latest versions of MS-DOS and
  844.          DR-DOS, as well as other products such as QEMM provide this
  845.          "load-high" facility). If you can, load as much as possible into
  846.          High Memory to relieve the pressure on the Base 640K. Otherwise
  847.          try removing any unwanted TSRs and drivers before loading paKet.
  848.  
  849.  
  850.  E. Insufficient space for this file.
  851.  
  852.     When receiving a Binary File, paKet will check the file size (once it
  853.     is known) and verify there is sufficient space on the drive to hold
  854.     the file.
  855.  
  856.     This will avoid wasted time by aborting the transfer before it starts
  857.     if the file is not going to fit.
  858.  
  859.  
  860.  E. Invalid argument
  861.  
  862.     This message will appear if you have specified an invalid DOS command.
  863.  
  864.     Check the command and reenter.
  865.  
  866.  
  867.                                Page 104
  868.  
  869.  E. Invalid colour in PAKET.CFG - (colour)
  870.  
  871.     There is something wrong with your PAKET.CFG file.
  872.  
  873.     As this file is maintained by the program itself, it is likely the
  874.     problem has been caused by some manual editing. If you can, restore an
  875.     earlier, working copy of the CFG file and try again. Otherwise you
  876.     should reinstall the paKet system and start again.
  877.  
  878.  
  879.  E. Invalid FLAG command in Script
  880.  
  881.     The Script file you have just loaded contains a command beginning with
  882.     F which suggests a Flag command but the syntax is invalid.
  883.  
  884.     Refer to the section on Script Processing for syntax details.
  885.  
  886.  
  887.  E. I/O Error - Bad Request
  888.  E. I/O Error - Data Error (CRC)
  889.  E. I/O Error - Drive not ready
  890.  E. I/O Error - General failure
  891.  E. I/O Error - Printer out of paper
  892.  E. I/O Error - Read fault
  893.  E. I/O Error - Sector not found
  894.  E. I/O Error - Seek Error
  895.  E. I/O Error - Unknown command
  896.  E. I/O Error - Unknown error type
  897.  E. I/O Error - Unknown media type
  898.  E. I/O Error - Unknown unit
  899.  E. I/O Error - Write fault
  900.  E. I/O Error - Write protected
  901.  
  902.     An error has occurred and paKet has attempted to identify the
  903.     particular error. These errors are documented in your computer's
  904.     Operating System documentation and are reasonably descriptive of the
  905.     problem.
  906.  
  907.     In most cases you will know what is causing the error as you will have
  908.     just performed some function, for example you will have requested a
  909.     directory display from a diskette, or you will have attempted to use
  910.     the printer.
  911.  
  912.     Refer to your DOS system documentation for further information on any
  913.     action to be taken.
  914.  
  915.     And refer to the description on the "Abort, Retry, Ignore" message for
  916.     discussion on the options available.
  917.  
  918.  
  919.  I. Loading Manual from (filename)
  920.  
  921.     When selecting the Online Manual, this message appears to let you know
  922.     it is working and it confirms the name of the file it is loading the
  923.     information from.
  924.  
  925.     It can take a few seconds, longer if loading from diskette, so you are
  926.     reassured the system is still working.
  927.  
  928.  
  929.                                Page 105
  930.  
  931.     If you get an "Insufficient memory" message here, it will be followed
  932.     by:
  933.        Continuing without Online Manual...
  934.     paKet will then continue with normal communications but, of course, in
  935.     that case you will not be able to view the Online Manual.
  936.  
  937.  
  938.  I. Loading (TNC-Helpfile-name) ...
  939.  
  940.     When you first select the TNC Help File, the index to the TNC commands
  941.     is loaded into memory. This can take a few seconds, more if you are
  942.     loading it from diskette, and this message appears so you can see the
  943.     system is still doing something!
  944.  
  945.     If you get an "Insufficient memory" message here, it will be followed
  946.     by:
  947.        Continuing without help file...
  948.     As the TNC Help file is optional anyway, paKet will continue with
  949.     normal communications although you will not be able to view the TNC
  950.     Help file.
  951.  
  952.  
  953.  E. Log file now closed because of file error
  954.     Further input held with <ScrollLock>
  955.  
  956.     A disk error has occurred while writing to the Log File.
  957.  
  958.     Perhaps the most likely cause is the disk has run out of space. You
  959.     can delete any unwanted files from paKet's online Disk Directory
  960.     Window (<Alt-D>) ; or you can exit to DOS with the <F9> key and fix
  961.     the problem there.
  962.  
  963.     If you were logging to diskette, you can replace that diskette and
  964.     open another log file on a new diskette.
  965.  
  966.     In most cases paKet will automatically switch on <ScrollLock> to hold
  967.     any input data in the buffer until you get the log file going again.
  968.     This way you will not lose anything from the log file.  When you have
  969.     rectified the problem, press <F2> to activate the Log file again (if
  970.     you want to) then press <ScrollLock> to release the data from the
  971.     Input Buffer.
  972.  
  973.  
  974.  W. Looks like a Disconnect?
  975.     REMOTE mode cancelled.
  976.  
  977.     paKet has detected what looks like a Disconnected message.
  978.  
  979.     If the other station disconnects we must shut down REMOTE mode because
  980.     if we are going to send the Menu, we must have someone to sent it to!
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991.                                Page 106
  992.  
  993. M to P
  994.  
  995.  E. Maximum 250 lines per 'page'
  996.  
  997.     When displaying the Online Manual or the TNC Help file, each "chapter
  998.     or section" is retained in memory for quick and easy scrolling. In
  999.     doing this I have imposed a limit of 250 lines for each chapter or
  1000.     section.
  1001.  
  1002.     This has proven to be quite ample and works fine with the files as
  1003.     distributed. So if this message appears, the file is either corrupted
  1004.     or has been changed by someone (and, come to think of it, isn't that
  1005.     the same thing?).
  1006.  
  1007.  
  1008.  I. Message file closed by Disconnect
  1009.  
  1010.     A "Disconnect" message was detected while paKet is receiving a PMS
  1011.     message.
  1012.  
  1013.     The Disconnect is processed and the Message File is closed to preserve
  1014.     whatever part of the message has been received so far.
  1015.  
  1016.  
  1017.  E. Must be .......
  1018.  
  1019.     When making changes to paKet's Online Configuration, there are some
  1020.     checks performed to ensure the new values entered are valid. paKet
  1021.     will issue a message in the above format to advise you if it thinks an
  1022.     error has been made.
  1023.  
  1024.  
  1025.  W. No, the TNC thinks we are NOT connected!
  1026.  
  1027.     After pressing <Alt-V> to verify the connected status, this message
  1028.     will appear if paKet thought there was a connection in the current
  1029.     window but the TNC disagrees, indicating there is NO connection.
  1030.  
  1031.     The Communications Window Header is changed to show "Not Connected".
  1032.  
  1033.  
  1034.  E. No messages available
  1035.  
  1036.     This message will appear in response to a PMS List request if there
  1037.     are no messages currently recorded.
  1038.  
  1039.  
  1040.  E. No such file or directory
  1041.  
  1042.     This error message occurs after an attempt to Rename or to Move a file
  1043.     with the <Alt-R> key.
  1044.  
  1045.     It would usually appear if you have specified a new sub directory in
  1046.     an attempt to move a file to another subdirectory, but the specified
  1047.     subdirectory does not exist on this drive.
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                Page 107
  1054.  
  1055.  E. Not enough free memory
  1056.  
  1057.     The external program you are trying to run will not fit into whatever
  1058.     memory is still available after paKet has taken what it needs.
  1059.  
  1060.     You might have to return to paKet and exit (<Alt-X>) before trying the
  1061.     other program again.
  1062.  
  1063.  
  1064.  W. Not found
  1065.  
  1066.     If you have initiated a search through the Flashback buffer for some
  1067.     text (via the <Alt-F> or the <Alt-L> keys) the matching text will be
  1068.     highlighted.  This message will appear if there is no (more) matching
  1069.     data in the buffer.
  1070.  
  1071.  
  1072.  E. Now I can't read the PMS DataBase file!
  1073.  
  1074.     An error has occurred trying to do some housekeeping on the PMS
  1075.     DataBase file.
  1076.  
  1077.     As far as the rest of the paKet processing is concerned, this is not a
  1078.     critical error because normal communications can continue without the
  1079.     PMS. So normal processing continues.  It is likely you will lose the
  1080.     messages that were in the PMS but check it out.
  1081.  
  1082.  
  1083.  W. paKet-Protocol Recovery denied
  1084.     This does NOT look like the same file
  1085.  
  1086.     We are receiving a Binary File from another station and our system had
  1087.     requested a paKet Protocol Recovery.
  1088.  
  1089.     This message appears if the other station has refused our request for
  1090.     a Recovery because it does not appear to be the same file.  The file
  1091.     already on our system will be preserved and a new file will be
  1092.     transfered in its entirety.
  1093.  
  1094.  
  1095.  W. paKet-Protocol Recovery approved
  1096.     Issuing approval to the receiver station...
  1097.  
  1098.     We are sending a Binary File and the other station has requested a
  1099.     Recovery of a partly completed file transfer.
  1100.  
  1101.     After checking the details provided by the other station, paKet has
  1102.     decided it DOES look like the same file and is sending its approval to
  1103.     the other station.  Now both sides can begin the transfer from the
  1104.     agreed point in the file.
  1105.  
  1106.  
  1107.  W. paKet-Protocol Recovery denied. The receiver's file does NOT match ours.
  1108.     The entire file will be sent from the beginning
  1109.  
  1110.     We are sending a Binary File and the other station has requested a
  1111.     Recovery of a partly completed file transfer.
  1112.  
  1113.  
  1114.  
  1115.                                Page 108
  1116.  
  1117.     After checking the details provided by the other station, paKet has
  1118.     decided it is NOT the same file and is sending a message to the other
  1119.     station, refusing the Recovery request.
  1120.  
  1121.  
  1122.  W. paKet-Protocol Recovery approved
  1123.     now appending to file...
  1124.  
  1125.     We are receiving a Binary File from another station and our system had
  1126.     requested a paKet Protocol Recovery.
  1127.  
  1128.     This message will appear if the Recovery is approved by the other
  1129.     station. The transfer will continue from the point where it aborted
  1130.     last time. It will be approved provided the other station is using
  1131.     paKet Protocol and both stations agree it seems to be the same file.
  1132.  
  1133.  
  1134.  W. paKet-Protocol Recovery requested by the receiver
  1135.     Attempting recovery - verifying file contents...
  1136.  
  1137.     We are sending a Binary File to another station and that station
  1138.     thinks we may have tried this one before, unsuccessfully, because a
  1139.     shorter version of the same file already exists on that system.
  1140.  
  1141.     Some details of that file have been provided by the other station and
  1142.     paKet is now checking to see if it could be the same file.
  1143.  
  1144.  
  1145.  I. Performing AUTOEXEC.SCP
  1146.  I. Performing AUTOEND.SCP
  1147.  
  1148.     The AUTOEXEC and AUTOEND Script files are optional.
  1149.  
  1150.     If the AUTOEXEC.SCP file is present paKet will run that Script as soon
  1151.     as it starts up (immediately after any Begin-Auto commands).  The
  1152.     Begin-Auto commands, which may be specified in the Configuration, are
  1153.     a simpler way to send any initialisation commands to the TNC but a
  1154.     Script provides more flexibility should the need arise. You can have
  1155.     both the Begin-Auto commands and the AUTOEXEC.SCP if you wish.
  1156.  
  1157.     When you press <Alt-X> to exit the program, paKet will look for the
  1158.     AUTOEND.SCP file and if present, it will run that Script before any
  1159.     End-Auto commands that may exist in the Configuration.
  1160.  
  1161.  
  1162.  E. Please close the log file first
  1163.  
  1164.     You should not edit a file that is already open and being used for
  1165.     something else. DOS gets horribly confused and upset.
  1166.  
  1167.     You will get this message if you try to edit the current Log File. If
  1168.     you really want to edit this Log file, press <F2> to close it first,
  1169.     then try the Edit command again.
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.                                Page 109
  1178.  
  1179.  E. Please enter a Message Number with the command.
  1180.     Eg: R 4
  1181.  
  1182.     In paKet's PMS, the messages are identified by a number. When you
  1183.     enter a command to process a message, the system needs to know which
  1184.     message you are referring to.
  1185.  
  1186.     Reenter the command, specifying the message number after the command
  1187.     as shown in the above example.
  1188.  
  1189.  
  1190.  W. Please take care with this. RESTART is the command mostly used.
  1191.     On most TNCs, RESET will clear everything including your MYCALL!
  1192.  
  1193.     This message will appear as a warning when you select the Serial Port
  1194.     Configuration  and change the item specifying the command to
  1195.     initialise your TNC.
  1196.  
  1197.     When changing Serial Port parameters, you will usually be changing
  1198.     both the TNC's parameters and the computer's parameters and need to
  1199.     keep the two devices synchronised in order to maintain communications.
  1200.     The way this is done is to send the commands to the TNC first because
  1201.     most TNCs will accept the changes but will not actually apply those
  1202.     changes until the TNC is re-initialised. Next, you change the
  1203.     Computer's Serial Port parameters.  paKet will then ask you if you
  1204.     would like to initialise the TNC and (if you reply 'Y') will send the
  1205.     RESTART command to the TNC.
  1206.  
  1207.     This works fine until I found the Kantronics range of TNCs are
  1208.     different to the others and require the RESET command instead of the
  1209.     RESTART command! So, in order to offer some support for these devices
  1210.     I added a configurable option to use either RESTART or RESET.
  1211.  
  1212.     This warning message appears whenever you select RESET because this
  1213.     command should be selected ONLY if you have a Kantronics TNC!  On all
  1214.     other TNCs I know of, the RESET command will clear EVERYTHING from
  1215.     it's memory including your callsign! You will have to enter all your
  1216.     settings again if you (or the program) send a RESET command to the
  1217.     TNC!
  1218.  
  1219.  
  1220.  D. Press any key to return to paKet...
  1221.  
  1222.     This message will appear briefly after an external program has been
  1223.     run. For example if you run a DOS command from the paKet screen (refer
  1224.     <F9> key) or Display (<Alt-D>) a file, you will often need to look at
  1225.     that screen before returning to normal communications.
  1226.  
  1227.  
  1228.  I. Pressing <F6> again will close the file
  1229.  
  1230.     This message will appear after you begin an ASCII Text File Receive
  1231.     operation with the <F6> key. It serves to remind you how to terminate
  1232.     the file transfer if the other station does not do so.
  1233.  
  1234.     All data received into this Communications Window will be written to
  1235.     the selected file until the other station sends a <Ctrl-Z> to close
  1236.     the file and terminate the File Transfer operation.
  1237.  
  1238.  
  1239.                                Page 110
  1240.  
  1241.     If the other station does not sent the <Ctrl-Z>, or if you wish to
  1242.     close the file part way through, you can press <F6> at any time and
  1243.     the file will be closed and the File Transfer terminated.
  1244.  
  1245.  
  1246.  C. Printer is not ready!
  1247.  
  1248.     The Printer status indicates it is not ready to accept any print data.
  1249.  
  1250.     When the printer is ready, press <Enter> and paKet will continue.
  1251.  
  1252.     If the Printer Log is already active, you may see some additional
  1253.     message text:
  1254.        "Esc to switch off Printing"
  1255.     In this case you could press <Esc> to clear this message and to switch
  1256.     off the Printer Log (same as pressing <Alt-P> again).
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.                                Page 111
  1302.  
  1303. R to S
  1304.  
  1305.  I. Receive file now closed
  1306.  
  1307.     An EOF was received while receiving ASCII file
  1308.  
  1309.     Normal condition - no action required.
  1310.  
  1311.  
  1312.  D. Receiving Binary file FROM BayCom
  1313.     Enter the file name in the BayCom system:
  1314.  
  1315.     When you request a Binary File transfer from a BayCom system, paket
  1316.     needs to know details of the file so it can generate the required
  1317.     commands to send to that system. If this command is used with Digicom
  1318.     (some versions), that system's name for the file may be one containing
  1319.     blanks or other oddities incompatible with a MS-DOS filename.
  1320.  
  1321.     If the BayCom system has the desired file in another directory you
  1322.     should also specify its sub directory name. For example if the file
  1323.     you want is called MYPROG.EXE and it is stored in the BayCom system's
  1324.     PRG directory, you would enter:
  1325.        PRG\MYPROG.EXE
  1326.  
  1327.     If it responds with a "file not found" error message, check the
  1328.     directory details with the BayCom operator. A common cause of this
  1329.     error would be if you inadvertently specify a leading "\", eg:
  1330.     \PRG\MYPROG.EXE
  1331.  
  1332.     This message will then be followed by:
  1333.        What should I call it here?
  1334.  
  1335.        paKet wants to know what name to give the file here on our system.
  1336.        You might normally use the same name as that in the BayCom system,
  1337.        but you can change it if you wish.
  1338.  
  1339.     And finally, the following message appears to ask for the file size:
  1340.        Now please enter file SIZE in bytes (-1 for Digicom):
  1341.  
  1342.        You should enter the size of the file you are transferring because
  1343.        the BayCom system may not tell us when the transfer is complete.
  1344.        The BayCom operator should be able to tell you the file size.
  1345.        If you do not know the file size in BYTES, enter 0 (zero).
  1346.  
  1347.        If you are trasnferring a file from a Digicom, enter -1 for the
  1348.        file size to tell paKet it is a Digicom transfer. You will still
  1349.        have to close th file manually.
  1350.  
  1351.  
  1352.  I. REMOTE deactivated by Disconnect
  1353.  
  1354.     The usual way to log off from REMOTE is to enter B for Bye or T for
  1355.     Talk. This message indicates the connection has been severed by a
  1356.     Disconnect command to the TNC at either end.
  1357.  
  1358.     No harm done and no action is required.
  1359.  
  1360.  
  1361.  
  1362.  
  1363.                                Page 112
  1364.  
  1365.  E. REMOTE is available only while Connected
  1366.  
  1367.     You have pressed <F3> to place paKet into REMOTE mode and to issue the
  1368.     menu to the other station, but paKet thinks we are currently not
  1369.     connected, so there is no other station to send the Menu to!
  1370.  
  1371.     Try it again after a connection is established.
  1372.  
  1373.     Occasionally paKet might fail to detect the connection and although
  1374.     you are really connected to another station, paKet shows "Not
  1375.     Connected" in the Communications Window Header Line.
  1376.  
  1377.     If this has happened you will not be able to enter REMOTE mode. You
  1378.     can correct this by pressing <Alt-V> to ask paKet to verify the
  1379.     connected status with the TNC. If this changes paKet from "Not
  1380.     Connected" to show a callsign in the Communications Window Header, you
  1381.     can then try the <F3> again.
  1382.  
  1383.  
  1384.  I. Returning to normal communications...
  1385.  
  1386.     You pressed B (Bye) after using the Sysop PMS Menu. This will release
  1387.     the <ScrollLock> condition and the system reverts to normal
  1388.     communications mode once again.
  1389.  
  1390.     This message informs you of the system's status.
  1391.  
  1392.  
  1393.  I. Saving configuration parameters in PAKET.CFG
  1394.  
  1395.     If you make any changes to paKet's Configuration, the changes are
  1396.     automatically saved to disk.
  1397.  
  1398.     This message confirms the action taking place.
  1399.  
  1400.  
  1401.  E. Script file not found
  1402.  
  1403.     After starting Script Processing with the <Alt-S> key, you have
  1404.     entered a Script file name, but paKet cannot find that file.
  1405.  
  1406.     Usually you would select a Script from the Directory Window so this
  1407.     message would be rare. However, if you have manually entered the file
  1408.     name, check the spelling and ensure you have entered any subdirectory
  1409.     details if necessary.
  1410.  
  1411.  
  1412.  E. Script label not found
  1413.  
  1414.     A Script command specifies a Script label but paKet cannot find that
  1415.     label in this Script.
  1416.  
  1417.     Refer to the Script Processing section of this Manual for details of
  1418.     Script syntax.
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.                                Page 113
  1426.  
  1427.  E. Script Processing Aborted
  1428.  
  1429.     If paKet detects a serious problem in your Script file, the Script
  1430.     will be aborted and paKet returns to normal communications mode.
  1431.  
  1432.     This message alerts you to the fact that the Script has NOT been
  1433.     executed.
  1434.  
  1435.  
  1436.  
  1437.  D. Sending Binary file TO BayCom
  1438.     Enter the file name in the BayCom system:
  1439.  
  1440.     When you request the transfer of a binary file to a BayCom system,
  1441.     paKet will ask for the name you want to give this file when it is
  1442.     written to the BayCom system. (You can send to some Digicom versions
  1443.     also).
  1444.  
  1445.     Usually it would be the same as the file name in our system but you
  1446.     can change it if you wish.
  1447.  
  1448.     Another reason for this message is to allow you to specify a
  1449.     sub-directory as well as a file name for the BayCom system. For
  1450.     example, say we are sending the file UTIL.EXE to a BayCom system and
  1451.     we want to write it to the BayCom user's PROG sub directory. So, in
  1452.     response to the above message you would enter:
  1453.        PROG\UTIL.EXE
  1454.     Of course paKet does not know what sub directories are available on
  1455.     the BayCom system - that is your job to find out.
  1456.  
  1457.  
  1458.  E. Someone else is connected to another stream.
  1459.     I cannot (yet?) handle multiple REMOTE operations.
  1460.  
  1461.     This error message:
  1462.       a. appears in a popup Message Window if you have pressed <F3> to put
  1463.          paKet into REMOTE mode when there is more than one station
  1464.          currently connected.
  1465.  
  1466.          Try it again later when you have only one station connected.
  1467.  
  1468.  
  1469.       b. will be sent to another station if that station sends the REMOTE
  1470.          Trigger in an attempt to activate our REMOTE menu while someone
  1471.          else is connected on another of our streams.
  1472.  
  1473.          The REMOTE Trigger will not be processed and the system will
  1474.          remain in normal communications mode.
  1475.  
  1476.  
  1477.  D. Sysop PMS menu: <B,H,K,L,R,S,?>
  1478.  
  1479.     This is the menu that appears when you press <Alt-M>.
  1480.  
  1481.     The PMS sub system is discussed in its own section of this Manual.
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.                                Page 114
  1488.  
  1489.  D. Sysop PMS Menu Help...
  1490.     B (Bye)  - End Sysop PMS Processing
  1491.     H (Help) - Display these details
  1492.     K (Kill) - Kill a message (eg K 3)
  1493.     L (List) - List available messages
  1494.     R (Read) - Read a message (eg R 3)
  1495.     S (Send) - Send a message (eg S (callsign))
  1496.     ? (Help) - Display these details
  1497.  
  1498.     This list of commands is available only from the Sysop PMS Menu. It
  1499.     appears in response to the H or ? command.
  1500.  
  1501.     If it is not self explanatory, I need to make a better help message!
  1502.  
  1503.  
  1504.  I. System Note at HH:MM:SS - msg
  1505.  
  1506.     A System Note is an information message that is a little different to
  1507.     other information messages in that it appears in the Communications
  1508.     Window (and optionally in the log file) rather than in the popup
  1509.     Message Window.
  1510.  
  1511.     These System Notes are mostly used to log information on the success
  1512.     or otherwise of a file transfer. These file transfer operations can be
  1513.     time consuming and the operator might start the transfer and go do
  1514.     something else while the file being transferred. So a brief popup
  1515.     message might not be seen and it was felt a more permanent record was
  1516.     required.
  1517.  
  1518.     Of course no action is required, as this type of message is designed
  1519.     to cater for those situations where the operator might not be present
  1520.     anyway.
  1521.  
  1522.     The HH:MM:SS is the computer's time when the System Note is issued.
  1523.     "msg" should be self-explanatory. For Example:
  1524.        "Upload successful - FILENAME.DAT"
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.                                Page 115
  1550.  
  1551. The...
  1552.  
  1553.  D. The EOF has not been acknowledged.
  1554.  
  1555.     We are sending a Binary File with pP or YAPP Protocol and have sent
  1556.     the last byte followed by the End-of-File code.  The other station
  1557.     should then acknowledge that code so we know the transfer has
  1558.     successfully completed.
  1559.  
  1560.     This message appears if the acknowledgement has still not arrived 2
  1561.     minutes after the EOF code was sent. (2 minutes is the time specified
  1562.     in the YAPP specifications).
  1563.  
  1564.     When paKet has sent the last byte and the EOF code, it starts counting
  1565.     the 2 minute timeout. In most cases 2 minutes is plenty of time for
  1566.     the other station to get the last of the data and close the file there
  1567.     before sending its acknowledgement.  However, some modern TNCs are
  1568.     equipped with a large buffer and although paKet has finished sending
  1569.     the file, your TNC might still have a significant part of it still in
  1570.     its buffers waiting to be transmitted! And if the TNC buffer is large,
  1571.     it could easily take more than 2 minutes for the buffer to be cleared.
  1572.  
  1573.     This message will pop up after 2 minutes to warn you we are still
  1574.     waiting for the acknowledgement. But, provided paKet is not in REMOTE
  1575.     mode, the following message will appear:
  1576.  
  1577.       Would you like to continue waiting for the acknowledgement? (Y/N)
  1578.  
  1579.     If you do happen to have a TNC with a large buffer, just reply "Y" and
  1580.     you will get another 2 minutes. The same messages will reappear at the
  1581.     end of that time if the acknowledgement has still not arrived.
  1582.  
  1583.     If you reply "N" the transfer will be aborted in accordance with the
  1584.     original YAPP specifications.
  1585.  
  1586.  
  1587.     If our paKet system is performing this Binary File transfer in REMOTE
  1588.     mode, you may not be around to answer the question. In that case the
  1589.     following message appears:
  1590.  
  1591.        but as I am in REMOTE mode I will continue waiting...
  1592.  
  1593.     and paKet will start another 2 minute timeout period. It will do this
  1594.     3 times (a total of 8 minutes waiting!) before aborting.
  1595.  
  1596.  
  1597.  W. The message file was not closed
  1598.  
  1599.     The other station started to send a message to our PMS but has
  1600.     disconnected without completing the message.
  1601.  
  1602.     paKet has closed the message file so the message, or at least that
  1603.     part that we had received, will be retained.
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.                                Page 116
  1612.  
  1613.  E. The other station seems to be in paKet REMOTE mode too.
  1614.     REMOTE mode cancelled!
  1615.  
  1616.     The other station has sent what looks like the paKet REMOTE menu while
  1617.     our system is also in REMOTE mode. They will go on sending the REMOTE
  1618.     Menu to each other, each time responding with an "Invalid option"
  1619.     message as the menu is received instead of a valid option!
  1620.  
  1621.     REMOTE mode is now disabled on this system to avoid the loop and the
  1622.     unnecessary exchange of error messages.
  1623.  
  1624.  
  1625.  E. The PMS index is missing so all messages are lost!
  1626.  E. The PMS data file is missing, so all messages are lost!
  1627.  
  1628.    Either (or both) these messages could appear if either file used
  1629.    for the PMS is no longer available.
  1630.  
  1631.    It is unlikely you have had a hardware problem or some sort of disk
  1632.    failure because you would have seen a different error message if that
  1633.    had happened.
  1634.  
  1635.     This problem is more likely to be due the the files being unavailable
  1636.     for some reason. Possible reasons include:
  1637.  
  1638.      1. you have deleted them;
  1639.         If so, that's tough! You've lost any messages that might have been
  1640.         in the PMS. If the data file (PAKETPMS.DAT) alone is still there,
  1641.         you can get a fair idea of the messages by reading it though.
  1642.  
  1643.  
  1644.      2. the Configuration file has been changed and paKet can no longer
  1645.         find the files;
  1646.         In this case, you should change the Configuration by entering
  1647.         <Alt-Z> then selecting option 8 (File/Directories) to correctly
  1648.         specify the location of the PMS files.
  1649.  
  1650.      3. The PMS files are on a diskette and that diskette is not in the
  1651.         drive.
  1652.         I don't think you need me to tell you what to do here.
  1653.  
  1654.  
  1655.  D. The Serial Port has been adjusted.
  1656.     Would you like me to send a RESTART to the TNC, now? (Y/N)
  1657.     I assume you have ALREADY set the TNC's parameters.
  1658.  
  1659.     These messages appear after you make some change to the computer's
  1660.     serial port via paKet's Online Configuration Window.
  1661.  
  1662.     Usually when you change one of these parameters, you should change the
  1663.     setting in the TNC too because if the two devices are not using the
  1664.     same settings they will not communicate.  The trick is to get them
  1665.     both changed at the same time.
  1666.  
  1667.     The recommended method is to:
  1668.      1. send the required commands to the TNC to change the TNC settings;
  1669.      2. then make the change in paKet's Configuration.
  1670.  
  1671.     Most TNCs will note the requested change but will not apply certain new
  1672.     settings until a RESTART command is issued.
  1673.                                Page 117
  1674.  
  1675.  
  1676.     So, after changing paKet's Configuration, paKet will optionally issue
  1677.     the RESTART command to the TNC to enable both devices to now continue
  1678.     with the new settings.
  1679.  
  1680.  
  1681.     Kantronics TNCs use the RESET command instead of RESTART so paKet has
  1682.     a configurable option (refer Serial Port options) and will send either
  1683.     RESTART or RESET depending on the option you choose.
  1684.  
  1685.  
  1686.  E. The TNC does not appear to be ready
  1687.  
  1688.     paKet is trying to send a character from a string of data to the TNC,
  1689.     but the TNC is unwilling to accept it at this time.
  1690.  
  1691.     paKet will wait up to 20 seconds without complaint, but any longer
  1692.     than that suggests a possible problem, so this message will appear to
  1693.     warn you. After this message appears, that character will be sent to
  1694.     the TNC anyway as in most cases the TNC will have an input buffer of
  1695.     80 free bytes or more and the character will not be lost.
  1696.  
  1697.     If the TNC is still locked after another 20 seconds, the next
  1698.     character will cause the message to be repeated.
  1699.  
  1700.     This message should appear quite rarely as under normal conditions you
  1701.     will not fill the TNC's buffers. If you are doing file transfers the
  1702.     buffers could fill but special handshaking logic in that part of the
  1703.     program will take care of it under those circumstances. If you have
  1704.     filled the buffers with lots of KB Macros, then slow down a bit!
  1705.  
  1706.     If you are using Software Handshaking, paKet will consider the TNC
  1707.     "not ready" if the TNC has sent an <XOFF> to indicate it cannot accept
  1708.     any more just yet.   paKet will remain in this "not ready" condition
  1709.     until an <XON> character is received, at which time data will flow
  1710.     normally once again.  However, just in case that <XON> character is
  1711.     lost or missed for some reason, you can manually reset the "not ready"
  1712.     condition by pressing <Alt-Q>.
  1713.  
  1714.     The only action you need to take here is to ensure the TNC and radio
  1715.     are functioning normally, and slow down if you are pumping in a lot of
  1716.     data from a Script or Macros.
  1717.  
  1718.  
  1719.  D. The TNC is not responding.
  1720.     Abort, Retry, Ignore  R
  1721.  
  1722.     When the program first starts up, it will attempt to establish
  1723.     communications with the TNC. If it gets no response, this message will
  1724.     appear to alert you to the possibility the TNC might not be switched
  1725.     on or the cables might not be properly connected.
  1726.  
  1727.     There are three options: A, R or I.
  1728.  
  1729.     A  is to ABORT the program and return to DOS. In this case, paKet will
  1730.        simply give up and you will see the DOS prompt reappear (or the
  1731.        menu if you started paKet from a menu).
  1732.  
  1733.        You may decide to take this option if you find something wrong with
  1734.        the TNC or its connections and prefer to do something else with the
  1735.                                Page 118
  1736.  
  1737.        computer while you attend to those problems. It is a quick and easy
  1738.        way out if communications with the TNC cannot be established.
  1739.  
  1740.     R  is the RETRY option. If you can fix the problem that caused this
  1741.        message to appear, selecting the RETRY option will allow paKet to
  1742.        continue as if the problem had not occurred.  Of course if you have
  1743.        not really fixed the problem you will get the message again!
  1744.  
  1745.     I  will IGNORE the problem and paKet's processing will continue.
  1746.  
  1747.        Normally I recommend against the Ignore option when an error
  1748.        occurs, however in this case it may be desirable to Ignore the
  1749.        error and allow paKet to continue, despite the lack of
  1750.        communication with the TNC.
  1751.  
  1752.        An example of this situation is where the problem is caused by a
  1753.        mismatch in the Serial Port settings. Either the TNC or the
  1754.        Computer must be changed to allow normal communications to take
  1755.        place. It is easier to change the Computer (paKet in this case).
  1756.  
  1757.        Type "I" to Ignore the errors and when the Initialisation is
  1758.        complete, you can select the Online Configuration's Serial Port
  1759.        Window to make the necessary changes. If you do this, don't forget
  1760.        the TNC's Date/Time may not be set and the usual initialisation
  1761.        commands may not have been processed by the TNC.
  1762.  
  1763.        Whenever I get into this situation, I make the necessary changes,
  1764.        then exit the program so I can make a good, fresh start.
  1765.  
  1766.        This "Ignore" option will also enable paKet to be used for serial
  1767.        communications with something OTHER than a TNC!  (e.g., a modem)
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.                                Page 119
  1798.  
  1799. T to U
  1800.  
  1801.  W. This Connected message is ignored because DCD line is LOW.
  1802.     (Check the DCDCON option in Configuration/Serial Port window)
  1803.  
  1804.     A "Connected" message has appeared in the Communications Window but
  1805.     has been ignored because the DCD line is still low.
  1806.  
  1807.     paKet uses the Connected message to determine when and to whom we are
  1808.     connected. Occasionally some text is monitored that looks like a
  1809.     Connected message and paKet gets confused, thnking there is a new
  1810.     Connection.
  1811.  
  1812.     If the DCDCON option is on in the TNC, paKet can check the DCD "light"
  1813.     to confirm we really ARE connected now.
  1814.  
  1815.     If a Connected message is detected but the DCD line is still low,
  1816.     paKet will treat that text as plain data and will display this
  1817.     message to advise you of the decision taken.
  1818.  
  1819.     Refer to the discussion on the DCDCON option in Configuration - Serial
  1820.     Port options and refer to the <Alt-V> key for more discussion on this
  1821.     issue.
  1822.  
  1823.     This feature is not used if you are using Software Handshaking.
  1824.  
  1825.  
  1826.  W. This file already exists.
  1827.     A new file, (filename), will be created.
  1828.  
  1829.     When receiving a file, paKet will check to see if the file already
  1830.     exists and if it does, paKet will issue this warning message.
  1831.  
  1832.     The original file will not be tampered with; instead paKet will create
  1833.     a new file, using the same file Name but with a new Extension. It will
  1834.     try to create a new file with an extension of .000 and if THAT file
  1835.     exists, it will try .001 etc. When it finds a filename/extension that
  1836.     does not already exist it will advise you of this filename in the
  1837.     above message.
  1838.  
  1839.     For example, if you are about to receive a file "TEXTFILE.DAT" and it
  1840.     already exists, paKet will create a new file "TEXTFILE.000".
  1841.  
  1842.  
  1843.  I. This new value will take effect next time you run paKet
  1844.  
  1845.     After making some changes to paKet's Configuration you may see this
  1846.     message to remind you that the changes you have made will not take
  1847.     effect immediately.
  1848.  
  1849.     There are some things that have to be accomlished at the beginning of
  1850.     the program, for example the allocation of memory for buffers. So if
  1851.     you want to change these things, you will have to exit and restart the
  1852.     program for the changes to become effective.
  1853.  
  1854.  
  1855.  E. Too many arguments
  1856.  
  1857.     This message will appear if you have specified an invalid DOS command.
  1858.     Check the command and reenter.
  1859.                                Page 120
  1860.  
  1861.  
  1862.  
  1863.  C. Too many connect entries
  1864.  
  1865.     There are too many entries in the Connect File and the program cannot
  1866.     hold any more. At the time of writing there is provision for 200
  1867.     connect entries.
  1868.  
  1869.     Delete any unwanted entries and if you really need more, you could
  1870.     establish more than one Connect File, specifying the chosen file name
  1871.     in the Configuration as required.
  1872.  
  1873.  
  1874.  E. Too many files
  1875.  
  1876.     This message will appear if you have selected a function that tries to
  1877.     display the paKet Directory Window, and paKet finds more than 400
  1878.     files in this particular directory or subdirectory.
  1879.  
  1880.     I have reserved space within paKet for handling directories containing
  1881.     up to 400 files. If you have a directory or sub directory with more
  1882.     than this number you will not be able to display that directory with
  1883.     paKet's Directory windows.
  1884.  
  1885.     I think the limit of 400 files is reasonable as there are certain
  1886.     inefficiencies in DOS's handling of very large directories.
  1887.  
  1888.     If you get this message, maybe it is time for a bit of housekeeping?
  1889.  
  1890.  
  1891.  E. Too many PMS messages here.
  1892.  
  1893.     I have allowed for a maximum of 200 current messages in your PMS. You
  1894.     couldn't possibly have that many, surely!
  1895.  
  1896.     Anyway, paKet can't hold any more so you will have to remove some of
  1897.     these to make room for any further messages.
  1898.  
  1899.  
  1900.  E. Too many sections in the Online Manual
  1901.  
  1902.     This error message means there are more index entries in the
  1903.     documentation file (the Manual) than I have allowed for.
  1904.  
  1905.     It is unlikely you will see this message, but if you do it is because
  1906.     someone has modified the Manual since I released it.
  1907.  
  1908.  
  1909.  E. Too many Traps in Script.
  1910.  
  1911.     The Script file you have just loaded contains more than 30 Traps.
  1912.  
  1913.     Script processing will continue with only the first 30 Traps active
  1914.     so be warned it may not be doing quite what you want!
  1915.  
  1916.     Refer to the section on Script Processing for details.
  1917.  
  1918.  
  1919.  
  1920.  
  1921.                                Page 121
  1922.  
  1923.  W. TRAP in Script ignored.
  1924.     You must specify 2 fields separated by comma!
  1925.  
  1926.     The Script file you have just loaded contains a command beginning with
  1927.     T which suggests a Trap command but the syntax is invalid.
  1928.  
  1929.     Refer to the section on Script Processing for syntax details.
  1930.  
  1931.  
  1932.  E. Type ahead buffer is full.
  1933.     Press <Enter> to send it or <Ctrl-Y> to clear it
  1934.  
  1935.     The Type Ahead buffer is limited to the number of lines visible on the
  1936.     screen. So if you have configured a two-line Type Ahead Window, you
  1937.     have a buffer capacity of two lines.
  1938.  
  1939.     When this buffer capacity is filled, paKet will not accept any further
  1940.     characters and you must either type <Enter> to send that buffer to the
  1941.     TNC or type <Ctrl-Y> to clear the buffer (without sending it).
  1942.  
  1943.  
  1944.  C. Unknown state in YAPP processing
  1945.  
  1946.     The YAPP specifications provide for a variety of conditions which the
  1947.     program must cater for but if there is a problem in the logic at some
  1948.     stage this message could occur. It is really a program bug so I hope
  1949.     you never see it!
  1950.  
  1951.     If you do see this message, the current Binary Transfer will most
  1952.     likely be unsuccessful. Try it again and if it still fails, you'd
  1953.     better let me know so I can attend to it. If you could arrange a copy
  1954.     of the file too that would help with my debugging.
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.                                Page 122
  1984.  
  1985. W to Z
  1986.  
  1987.  E. WAIT in Script needs time and a string separated by ,
  1988.  
  1989.     The Script file you have just loaded contains a command beginning with
  1990.     W which suggests a Wait command but the syntax is invalid.
  1991.  
  1992.     Refer to the section on Script Processing for syntax details.
  1993.  
  1994.  
  1995.  E. We seem to be in Command mode.
  1996.     REMOTE mode cancelled.
  1997.  
  1998.     The TNC should not be in Command mode while paKet is in REMOTE mode.
  1999.  
  2000.     If paKet is in REMOTE Mode it will be issuing the REMOTE Menu. If the
  2001.     TNC is in Command mode the Menu will not be transmitted to the other
  2002.     station, but will be taken by the TNC as some sort of "command" and
  2003.     will be rejected with "What?" or "Eh?" etc.
  2004.  
  2005.     REMOTE mode is now disabled so you can perform your TNC commands.
  2006.  
  2007.     When you have finished with the TNC's Command mode, place the TNC back
  2008.     into CONVERS mode and, if you then want to issue the REMOTE Menu to
  2009.     the other station, press <F3>.
  2010.  
  2011.  
  2012.  W. We seem to have lost DCD. REMOTE cancelled.
  2013.  
  2014.     paKet was in REMOTE mode and the DCD line goes low, indicating the
  2015.     connection with the other station has been lost.
  2016.  
  2017.     In normal circumstances paKet detects the "Disconnected" message when
  2018.     the other station disconnects, and will automatically deactivate
  2019.     REMOTE mode (if the other station has not logged off normally).
  2020.  
  2021.     paKet will also monitor the state of the DCD line during REMOTE
  2022.     operations because if you are using Hardware Handshaking, the DCD line
  2023.     can be used by the TNC to indicate the other station is still
  2024.     connected. So, if the DCD line goes low, paKet will disable REMOTE
  2025.     mode and will issue this message to inform you of the action taken.
  2026.  
  2027.     This will only occur if you have specified the use of the DCDCON
  2028.     option in the Configuration - Serial Port options.
  2029.  
  2030.  
  2031.  D. Which Drive?
  2032.  
  2033.     This question appears after you select "Change to another drive" from
  2034.     the Directory Window.
  2035.  
  2036.     Enter a valid drive letter, it may be either Upper or lower case and
  2037.     the colon is optional.
  2038.  
  2039.  
  2040.  E. Without the filesize I wont know when the transfer is finished
  2041.     You will have to close the file manually (with <Alt-F8>)
  2042.  
  2043.     You are about to receive a Binary File from a BayCom station (after
  2044.     pressing <Alt-F8>) but you have entered a file size of zero.
  2045.                                Page 123
  2046.  
  2047.     This message reminds you it is up to you to close the file when you
  2048.     think the transfer has finished. It is quite likely the BayCom system
  2049.     will simply stop sending when the last byte has been transmitted -
  2050.     there may be no indication from that station that the transfer is
  2051.     finished.
  2052.  
  2053.  
  2054.  D. Would you like to continue logging to this file? (Y/N)
  2055.  
  2056.     After completing the <Alt-W> function to write the contents of the
  2057.     Flashback buffer to disk, paKet can optionally continue logging to
  2058.     this same file.
  2059.  
  2060.     If you answer "Y", the effect is the same as if you press <F2> to open
  2061.     a Log File and specify that same file as your Log File.
  2062.  
  2063.  
  2064.  D. Write Flashback buffer to disk
  2065.     The LOG file is open - add to this LOG file? (Y/N)
  2066.  
  2067.     If the log file is currently open when you select <Alt-W>, paKet will
  2068.     give you the opportunity to write the Flashback buffer to the existing
  2069.     log file so you can keep it all together.
  2070.  
  2071.     If you wish to do this, reply "Y".   If you reply "N", paKet will ask
  2072.     you for details of the file that is to contain the contents of the
  2073.     buffer.
  2074.  
  2075.  
  2076.  E. YAPP command must be YD or YU
  2077.  
  2078.     This message could appear if you have specified a "Y" command in a
  2079.     Script but the command is invalid.
  2080.  
  2081.     Refer to the section on Script Processing for syntax details.
  2082.  
  2083.  
  2084.  W. You can close the file manually with <Alt-F8> if you wish
  2085.  
  2086.     When receiving a Binary File from a BayCom system, paKet may not know
  2087.     when to close the file because the BayCom system may not indicate when
  2088.     the transfer is complete.
  2089.  
  2090.     If paKet knows the size of the file, it can close the file after that
  2091.     number of bytes have been received but sometimes the file size is not
  2092.     known. In these cases it is up to the operator to close the file
  2093.     manually by pressing the <Alt-F8> key.
  2094.  
  2095.     This message pops up to remind you of this option if nothing has been
  2096.     received from the BayCom system for a while. I figured that if the
  2097.     other station has stopped sending maybe it has finished? However the
  2098.     decison is yours and yours alone!
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.                                Page 124
  2108.  
  2109. PART VI - REMOTE Mode
  2110. Overview
  2111.  
  2112.  Description.
  2113.    paKet's REMOTE Mode is a facility that allows other users to access and
  2114.    use our paKet system, even while our system is unattended. A REMOTE
  2115.    Menu will be issued to the other station and paKet REMOTE will respond
  2116.    to any of the valid Menu options.
  2117.  
  2118.    REMOTE Mode would be used mainly for the PMS (Personal Message System)
  2119.    or for File Transfers, both ASCII text and Binary.
  2120.  
  2121.    For your protection, the other station will have access only to the
  2122.    directory or directories you specify. The rest of your system will be
  2123.    both invisible and inaccessible to the remote operator. You may choose
  2124.    to disallow all REMOTE operations; or you may disallow just file
  2125.    Uploads or file Downloads. It is your system - you decide what the
  2126.    remote operator can see and do.  Refer to the section on "Configuration
  2127.    Windows - REMOTE Mode options" for details on choosing these options.
  2128.  
  2129.    The operation of REMOTE Mode is somewhat similar to most popular BBS
  2130.    systems currently available.  paKet has a PMS where the other station
  2131.    can send and receive messages, but it is important to note this is not
  2132.    a BBS and does not have any Mail Forwarding facilities. Details of the
  2133.    PMS are covered more fully in its own section in this Manual.
  2134.  
  2135.    While REMOTE Mode is active, the Status Window displays the word
  2136.    "REMOTE" to the left of the time display.
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.                                Page 125
  2170.  
  2171. Activating REMOTE Mode.
  2172.  
  2173.    REMOTE Mode can only be activated while we are connected to another
  2174.    station.
  2175.  
  2176.    There are three ways to put our system into REMOTE Mode:
  2177.       1. Automatic
  2178.          You can configure the system to automatically switch into REMOTE
  2179.          Mode when another station connects to our system.
  2180.  
  2181.          Details on how to do this are explained in the section on
  2182.          "Configuration Windows - REMOTE Mode options" in this Manual.
  2183.  
  2184.  
  2185.       2. REMOTE Trigger
  2186.          The other station can send the REMOTE Trigger code. This code
  2187.          too, is configurable although most stations would use the
  2188.          default which is the <Ctrl-]> (that is Ctrl key with
  2189.          right-square-bracket or ASCII value 29).
  2190.  
  2191.          Why such an unusual combination? Well it should be unusual and
  2192.          unique otherwise we would find paKet switching into REMOTE Mode
  2193.          unnecessarily! And most of the other codes were already being
  2194.          used for something or were commonly used as special TNC command
  2195.          values. <Ctrl-]> seemed to be about the only one left!
  2196.  
  2197.          It was found in testing that some Commodore 64 systems cannot
  2198.          send <Ctrl-]>. A DIGICOM user can send that code by pressing
  2199.          <Ctrl-=>, that is: Ctrl and the "equals" key!  If you find some
  2200.          users cannot manage to send the REMOTE Trigger I suggest the best
  2201.          solution is to enable the Automatic REMOTE mode so they will get
  2202.          the REMOTE Menu on connection and will not have to worry about
  2203.          the Trigger code. For some it is easier to get out of REMOTE Mode
  2204.          than to get into it!
  2205.  
  2206.          The Trigger code must be sent as the first and only character on
  2207.          the line if it is to be recognised by paKet as a REMOTE Trigger.
  2208.  
  2209.          If you want to specify some other code for the REMOTE Trigger,
  2210.          refer to the "Configuration Windows - REMOTE options" section of
  2211.          this Manual for details on how to change it.
  2212.  
  2213.          If you intend to use this Trigger method to provide access to
  2214.          your REMOTE system, I suggest you put something into the CTEXT
  2215.          message to advise the other stations to press <Ctrl-]> (or
  2216.          whatever) to activate REMOTE Mode.  The "Begin" and "End"
  2217.          auto-commands can be used to alter this message according to
  2218.          whether paKet is active or not.
  2219.  
  2220.       3. You can press the <F3> key to switch into REMOTE Mode and send
  2221.          the first REMOTE Menu to the other station.
  2222.  
  2223.    Note, while in REMOTE Mode the other station has control of your system
  2224.    so if you want to talk to that operator or issue some other commands,
  2225.    you should disable REMOTE Mode first with the <F3> key.
  2226.  
  2227.    While you are in REMOTE Mode, any of your keystrokes will be taken as
  2228.    if those characters were RECEIVED from the other station! So if that
  2229.    operator is having difficulty with some of your REMOTE options, you can
  2230.    help by typing the correct commands for them!
  2231.                                Page 126
  2232.  
  2233. Leaving REMOTE Mode
  2234.  
  2235.    There are four ways REMOTE Mode can be cancelled:
  2236.  
  2237.       1. The other station can enter "B", which is the REMOTE Menu command
  2238.          for "Bye" indicating the user is finished and wants to disconnect.
  2239.  
  2240.          paKet will:
  2241.             disable REMOTE Mode;
  2242.             send "Logged Off" to confirm acceptance of the Bye command;
  2243.             then issue the Disconnect command to the TNC.
  2244.  
  2245.       2. The other station can enter "T", which is the REMOTE Menu command
  2246.          for "Talk" indicating the user no longer wants to use the REMOTE
  2247.          Menu, preferring to continue this session communicating with us
  2248.          in normal communications mode.
  2249.  
  2250.          paKet will:
  2251.             send a message to the other station accepting the Talk command;
  2252.             disable REMOTE Mode.
  2253.             sound the "telephone" bell (if bells are enabled);
  2254.  
  2255.          If you are not present, the other station can then either
  2256.          Disconnect the session or send the REMOTE Trigger to get the Menu
  2257.          back again.
  2258.  
  2259.       3. You could press <F3> to manually switch the system out of REMOTE
  2260.          Mode. The effect of this is similar to the other station sending
  2261.          the "Talk" command.
  2262.  
  2263.          paKet will send a message to the other station advising them they
  2264.          are no longer in REMOTE Mode.
  2265.  
  2266.       4. If the other station Disconnects or if the link between the two
  2267.          stations fails (which causes a Disconnect in our TNC anyway)
  2268.          paKet will automatically disable REMOTE Mode as part of the
  2269.          Disconnect process.
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.                                Page 127
  2294.  
  2295. The REMOTE Menu - Commands A to L
  2296.  
  2297.    paKet REMOTE will issue the following Menu to the other station and
  2298.    will then wait for one of those options to be entered:
  2299.  
  2300.    paKet (VK2DHU) (A,B,D,H(elp),I,K,L,MD,MU,MW,R,S,T,U,V,W,YD,YU,YW,?) >
  2301.  
  2302.    The callsign shown will be your callsign as specified in the
  2303.    Configuration Windows - Miscellaneous options.
  2304.  
  2305.    The other station must enter one of the these option, otherwise paKet
  2306.    will issue an "Invalid Option" message.
  2307.  
  2308.    Menu commands are:
  2309.  
  2310.    A  - Abort a file transfer
  2311.         This might be used by the other station if an ASCII text file
  2312.         transfer is in progress and they decide the rest of it is not
  2313.         required.  A quantity of data is already in the TNC's buffer and
  2314.         will be sent anyway.
  2315.  
  2316.  
  2317.    B  - Bye (logoff)
  2318.         This option will disable REMOTE Mode and issue a Disconnect
  2319.         command to our TNC to disconnect the other station.
  2320.  
  2321.  
  2322.    D  - Download an ASCII text file
  2323.         This operation is a Download from the remote operator's point of
  2324.         view: an ASCII text file is being sent from our system to the
  2325.         other station.
  2326.  
  2327.         The remote operator must send the required filename along with the
  2328.         "D" command, for example:
  2329.            D TEXTFILE.DAT
  2330.         The file will be taken from our Text Send directory (specified in
  2331.         Configuration Windows - File/Directories) or one of its
  2332.         subdirectories. If the desired file is in a subdirectory, the
  2333.         directory path must be specified as well.
  2334.  
  2335.         I think an example is needed here. Suppose our directory tree
  2336.         looks something like this and you have specified "C:\PAKET\TEXT\"
  2337.         as our Text Send Directory.
  2338.  
  2339.              C:\
  2340.              ├──DOS
  2341.              ├──PAKET
  2342.              │  ├──BIN
  2343.              │  │  ├──GAMES
  2344.              │  │  ├──MISC
  2345.              │  │  ├──SATS
  2346.              │  │  ├──UPLOAD
  2347.              │  │  └──UTILS
  2348.              │  ├──TEXT               < These are the only directories
  2349.              │  │  ├──BASIC           < the Remote operator can see or
  2350.              │  │  ├──DOCS            < access with the D or W commands
  2351.              │  │  ├──MISC            < if C:\PAKET\TEXT\ is specified
  2352.              │  │  ├──HUMOUR          < as our Text Send directory.
  2353.              │  │  └──UPLOAD          <
  2354.              ├──UTILITY
  2355.                                Page 128
  2356.  
  2357.         Then as far as the Remote operator is concerned, our C:\PAKET\TEXT
  2358.         directory, and its subdirectories BASIC, DOCS, MISC, HUMOUR and
  2359.         UPLOAD are available. Our other directories such as DOS and
  2360.         UTILITY are quite invisible and cannot be accessed.
  2361.  
  2362.         So, if the file TEXTFILE.DAT exists in our C:\PAKET\TEXT
  2363.         directory, the remote operator can enter the command:
  2364.            D TEXTFILE.DAT
  2365.         and paKet will find (and send) that file.
  2366.  
  2367.         If the Remote operator wants a file, LAFF.DAT, in our
  2368.         C:\PAKET\TEXT\HUMOUR\ directory, the following command is
  2369.         required:
  2370.            D HUMOUR\LAFF.DAT
  2371.  
  2372.         An attempt to access another directory will result in an error
  2373.         message being sent. For example if the Remote operator sent a
  2374.         command:
  2375.            D \DOS\README.DAT
  2376.         paKet would innocently reply that it can't find that file, even if
  2377.         that README.DAT file DID exist in our DOS directory!
  2378.  
  2379.         If you do not want another station to transfer any of our files
  2380.         you can disable this option - refer to "Configuration Windows -
  2381.         REMOTE options" for details. The option would still appear in the
  2382.         Menu but the remote operator would get an error message if that
  2383.         option were selected.
  2384.  
  2385.  
  2386.    H  - Help
  2387.    ?  - Help
  2388.  
  2389.         The contents of the "REMOTE.HLP" file will be sent to the other
  2390.         station if either of these commands are sent by the remote
  2391.         operator.
  2392.  
  2393.         This file must be available in the "current directory", that is
  2394.         the directory DOS was using when you started the paKet program.
  2395.  
  2396.         A sample REMOTE.HLP file is supplied with paKet. This file is
  2397.         plain ASCII text so you can change it to suit your own system. For
  2398.         example if you do not wish to allow File Uploads, you might like
  2399.         to remove that detail from your copy of the Help file.
  2400.  
  2401.  
  2402.    I  - Information about this system
  2403.  
  2404.         The contents of the "REMOTE.INF" file will be sent to the other
  2405.         station.
  2406.  
  2407.         This file must be available in the "current directory", that is
  2408.         the directory DOS was using when you started the paKet program.
  2409.  
  2410.         A sample REMOTE.INF file is supplied with paKet. This file is
  2411.         plain ASCII text so you can change it to suit your own
  2412.         circumstances. For example you might like to add some details of
  2413.         your computer system, your TNC, your QTH, or any special interests
  2414.         you have.
  2415.  
  2416.  
  2417.                                Page 129
  2418.  
  2419.    K  - Kill a message from paKet's PMS system
  2420.  
  2421.         The remote operator may remove any message sent BY that station or
  2422.         addressed TO that station.
  2423.  
  2424.         The messages are identified by number so the command must include
  2425.         the message number that is to be removed, eg: K 5.
  2426.  
  2427.         If possible, paKet will delete that message from the PMS Database
  2428.         and will advise the remote operator of the result of this
  2429.         operation.
  2430.  
  2431.         Refer to the discussion on the PMS system in its own section of
  2432.         this Manual for more details.
  2433.  
  2434.  
  2435.    L  - List available messages in paKet's PMS Database
  2436.  
  2437.         Upon receipt of this command paKet will send a complete listing of
  2438.         all messages currently stored in our PMS Database, showing one
  2439.         message per line.
  2440.  
  2441.         Although all messages are listed here, the remote operator can
  2442.         access only those messages sent by or addressed to that station,
  2443.         or messages addressed to ALL.
  2444.  
  2445.         Refer to the discussion on the PMS system in its own section of
  2446.         this Manual for more details.
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.  
  2463.  
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.                                Page 130
  2480.  
  2481. The REMOTE Menu - Commands MD to MW (BayCom commands)
  2482.  
  2483.    MD - Download a Binary file to a BayCom system
  2484.  
  2485.         This operation is a Download from the remote operator's point of
  2486.         view: a binary file is being sent from our system to the other
  2487.         station which presumably is using BayCom.
  2488.  
  2489.         The remote operator must send the required filename along with the
  2490.         "MD" command, for example:
  2491.            MD PROGRAM.EXE.
  2492.         The file will be taken from our Binary Send directory (specified
  2493.         in Configuration Windows - File/Directories) or one of its sub
  2494.         directories. If the desired file is in a subdirectory, the
  2495.         directory path must be specified as well.
  2496.  
  2497.         For example, if you refer to the sample Directory Tree shown under
  2498.         the REMOTE D (Download) command above, suppose you have specified
  2499.         C:\PAKET\BIN\ as our Binary Send Directory and the required file
  2500.         is USEFUL.COM in our C:\PAKET\BIN\UTILS sub directory.  The
  2501.         command required from the remote operator would be:
  2502.            MD UTILS\USEFUL.COM
  2503.         Of course, if the file is in the C:\PAKET\BIN\ directory, only the
  2504.         filename would be required.
  2505.  
  2506.         If you were not in REMOTE Mode and were performing this transfer
  2507.         via the <F7> key, paKet would ask which filename and directory
  2508.         should be used on the BayCom system. But as this operation is
  2509.         actually being performed by the remote BayCom operator, paKet
  2510.         won't ask that question, leaving the BayCom operator to make his
  2511.         own decisions.
  2512.  
  2513.         paKet will:
  2514.            set up the necessary parameters in the TNC;
  2515.            display the Binary File Transfer Window;
  2516.            send the //WPRG command to the BayCom system
  2517.            send the file
  2518.            send the //WPRG OFF command to the BayCom system.
  2519.  
  2520.         Refer to the section on the Binary File Transfer Window for
  2521.         details of the display and also refer to the "Keyboard Commands"
  2522.         section of this Manual, where the discussion on the <Alt-F7> key
  2523.         provides some more detail on sending a Binary File to a BayCom
  2524.         system.
  2525.  
  2526.         When the transfer is complete, paKet will return to REMOTE Mode
  2527.         and the Menu will be reissued to the other station.
  2528.  
  2529.         If you do not want another station to transfer any of our files
  2530.         you can disable this option - refer to "Configuration Windows -
  2531.         REMOTE options" for details.
  2532.  
  2533.  
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.                                Page 131
  2542.  
  2543.    MU - Upload a binary file from a BayCom system
  2544.  
  2545.         This operation is an Upload from the remote operator's point of
  2546.         view: a Binary File is being sent to our system from the other
  2547.         station which presumably is a BayCom system.
  2548.  
  2549.         That file will be stored in our Binary Recv directory (specified
  2550.         in Configuration Windows - File/Directories). For your protection,
  2551.         paKet will not allow the remote operator to specify a drive or
  2552.         directory.
  2553.  
  2554.         The remote operator must provide the filename and filesize along
  2555.         with the "MU" command, for example:
  2556.            MU PROGRAM.EXE,54257
  2557.  
  2558.         We need the filesize because the BayCom system does not tell us
  2559.         when the file transfer has finished. If the filesize is known
  2560.         paKet can count the bytes received and close the file when they
  2561.         have all been received.
  2562.  
  2563.         If the filesize is not known, a 0 may be entered to allow the
  2564.         transfer to continue but the file will have to be closed manually.
  2565.         The BayCom operator can do this by entering the BayCom end-of-file
  2566.         string: <CR>//WPRG OFF<CR>. (The end-of-file string must be entered
  2567.         exactly as specified otherwise it will not be recognised as the
  2568.         end-of-file string and will be added to the file!)   If that
  2569.         string is not entered, paKet will close the file after 2 minutes
  2570.         of inactivity. If present, you can close the file yourself with
  2571.         the <Alt-F8> key.
  2572.  
  2573.         It would be much better if the BayCom operator can specify the
  2574.         filesize!
  2575.  
  2576.         When the required information has been entered, paKet will:
  2577.            set up the necessary parameters in the TNC;
  2578.            display the Binary File Transfer Window;
  2579.            send the BayCom //RPRG command;
  2580.            begin the transfer;
  2581.  
  2582.         Refer to the discussion on BayCom Binary File Transfers under
  2583.         <Alt-F8> in the "Keyboard Commands" section in this Manual for
  2584.         more details.
  2585.  
  2586.         When paKet determines the transfer is complete, the file is closed
  2587.         and the REMOTE Menu is reissued to the other station.
  2588.  
  2589.         If you do not want another station to send any files to our
  2590.         system, you can disable this Upload option - refer to
  2591.         "Configuration Windows - REMOTE options" for details.
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.                                Page 132
  2604.  
  2605.    MW - What files are available in the Binary Send Directory
  2606.  
  2607.         If the remote operator sends a "MW" command, paKet REMOTE will
  2608.         send a sorted list of filenames found in our Binary Send
  2609.         directory, including the directory names of any subdirectories
  2610.         found in that Binary Send directory.
  2611.  
  2612.         If a list of files in one of those Binary Send subdirectories is
  2613.         required, the REMOTE operator may add that directory name to the
  2614.         MW Command. Eg:
  2615.            MW UTILS
  2616.  
  2617.         Processing for the MW command is identical to that for the YW
  2618.         command so refer to that command below for details. The REMOTE
  2619.         operator could enter the YW command to get an identical response.
  2620.         However, the BayCom user has Upload (MU) and Download (MD)
  2621.         commands so this MW command is provided for consistency.
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.  
  2650.  
  2651.  
  2652.  
  2653.  
  2654.  
  2655.  
  2656.  
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.                                Page 133
  2666.  
  2667. The REMOTE Menu - Commands R to W
  2668.  
  2669.    R  - Read a message from paKet's PMS
  2670.  
  2671.         The remote operator wants to read a message that is stored in our
  2672.         PMS Database.
  2673.  
  2674.         The messages are identified by number so the command must include
  2675.         the message number, eg: R 4.
  2676.  
  2677.         The remote operator may read any message sent BY that station,
  2678.         addressed TO that station, or to ALL. So, provided that station is
  2679.         allowed access, paKet will send the contents of the specified
  2680.         message.
  2681.  
  2682.         Refer to the discussion on the PMS system in its own section of
  2683.         this Manual for more details.
  2684.  
  2685.  
  2686.    S  - Send a message to paKet's PMS system
  2687.  
  2688.         The remote operator wants to send a message, either to you or to
  2689.         another station. A message addressed to ALL is as close as we get
  2690.         to allowing Bulletins in this system.
  2691.  
  2692.         Actually the message is not sent anywhere - it stays here and is
  2693.         recorded in our PMS Database.  However, most other PMS systems use
  2694.         this same syntax to "Send" a message, so I have conformed and used
  2695.         the same style for storing a message in paKet's PMS.
  2696.  
  2697.         If a callsign is provided on the command line, eg: S VK2DHU the
  2698.         PMS will record the message as being addressed to that station but
  2699.         if no callsign is given, paKet will assume the message is to be
  2700.         addressed to you. Your callsign will be that specified in the
  2701.         Configuration Windows - Miscellaneous options.
  2702.  
  2703.         The message will be recorded as FROM the Remote operator's
  2704.         callsign which appears in the Communications Header Line while we
  2705.         are connected.
  2706.  
  2707.         Refer to the discussion on the PMS system in its own section of
  2708.         this Manual for more details.
  2709.  
  2710.  
  2711.    T  - Talk to the paKet operator
  2712.  
  2713.         This option will disable REMOTE Mode, ring the telephone-style
  2714.         connect bell and return our paKet system to normal communications.
  2715.  
  2716.         If you are not present, the telephone bell will ring up to 10
  2717.         times. The remote operator can either send the REMOTE Trigger to
  2718.         get the Menu back again or simply Disconnect the session.
  2719.  
  2720.  
  2721.    U  - Upload an ASCII text file
  2722.  
  2723.         This operation is an Upload from the remote operator's point of
  2724.         view: an ASCII text file is being sent to our system from the
  2725.         other station.
  2726.  
  2727.                                Page 134
  2728.  
  2729.         That file will be stored in our Text Recv directory (specified in
  2730.         Configuration Windows - File/Directories). For your protection,
  2731.         paKet will not allow the remote operator to specify a drive or
  2732.         directory. On my system I use a sub directory called UPLOAD and
  2733.         anything that is sent to me will appear in that directory. Of
  2734.         course you may use any directory name you wish, including the Root
  2735.         directory if that's what you want.
  2736.  
  2737.         The remote operator must provide the filename along with the "U"
  2738.         command, for example:
  2739.            U TEXTFILE.DAT.
  2740.  
  2741.         This file will be closed when paKet receives a <Ctrl-Z>.
  2742.  
  2743.         If you do not want another station to send any files to our
  2744.         system, you can disable this Upload option - refer to
  2745.         "Configuration Windows - REMOTE options" for details.
  2746.  
  2747.  
  2748.    V  - Version number of this system
  2749.  
  2750.         When this option is specified, paKet will send the version number
  2751.         of this paKet program.
  2752.  
  2753.         It may be useful for the remote operator to know which version we
  2754.         are currently using as some versions of the program might behave
  2755.         differently.
  2756.  
  2757.  
  2758.    W  - What ASCII text files are available
  2759.  
  2760.         If the remote operator sends a "W" command, paKet REMOTE will send
  2761.         a sorted list of filenames found in our Text Send directory,
  2762.         including the directory names of any subdirectories found in that
  2763.         Text Send directory.
  2764.  
  2765.         The available space on that drive will be sent. If our Text Send
  2766.         and Text Recv directories are on different drives, the available
  2767.         space on the Text Recv drive will also be sent. This allows the
  2768.         other operator to see how much space is available before uploading
  2769.         a file to our system.
  2770.  
  2771.         If the remote operator wants to see a directory listing of one of
  2772.         the subdirectories, the desired directory name must be entered
  2773.         with the W command. For example, using the sample directory tree
  2774.         shown in the REMOTE D (Download) command above, suppose the remote
  2775.         operator wanted a listing of our BASIC directory, the following
  2776.         command would be required:
  2777.            W BASIC
  2778.  
  2779.         Refer to the REMOTE D (Download) command above for a full
  2780.         discussion on the use of subdirectories.
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.                                Page 135
  2790.  
  2791. The REMOTE Menu - Commands YD to YW (YAPP or pP Commands)
  2792.  
  2793.    YD - Download a Binary file using pP or YAPP protocol
  2794.  
  2795.         This operation is a Download from the remote operator's point of
  2796.         view: a Binary File is being sent from our system to the other
  2797.         station using either pP (paKet Protocol) or YAPP protocol.
  2798.  
  2799.         The remote operator must send the required filename along with the
  2800.         "YD" command, for example:
  2801.            YD PROGRAM.EXE.
  2802.         The file will be taken from our Binary Send directory (specified
  2803.         in Configuration Windows - File/Directories) or one of its sub
  2804.         directories. If the desired file is in one of our sub directories,
  2805.         the directory path must be specified as well. "Wildcards" or
  2806.         multiple file specifications (eg: *.EXE) may be used to cause
  2807.         downloading of more than one file in the same transaction,
  2808.         provided the remote station also supports this feature. Of course
  2809.         if that remote station is also running paKet, it is supported.
  2810.  
  2811.         For example, if you refer to the sample Directory Tree shown under
  2812.         the REMOTE D (Download) command above, suppose you have specified
  2813.         C:\PAKET\BIN\ as our Binary Send Directory and the required file
  2814.         is USEFUL.COM in our C:\PAKET\BIN\ directory. The command required
  2815.         from the remote operator is:
  2816.            YD USEFUL.COM
  2817.         If that file was in our UTILS sub directory, the command required
  2818.         from the remote operator would be:
  2819.            YD UTILS\USEFUL.COM
  2820.  
  2821.         paKet will:
  2822.            set up the necessary parameters in the TNC;
  2823.            display the Binary File Transfer Window;
  2824.            synchronise with the other station; then
  2825.            begin the transfer(s).
  2826.  
  2827.         Refer to the section on the Binary File Transfer Window for
  2828.         details of the display and also refer to the "Keyboard Commands"
  2829.         section of this manual, where the discussion on the <F7> key
  2830.         provides some more information on sending a Binary File.
  2831.  
  2832.         When the transfer is complete, paKet will return to REMOTE Mode
  2833.         and the Menu will be reissued to the other station.
  2834.  
  2835.         If you do not want another station to transfer any of your files
  2836.         you can disable this option - refer to "Configuration Windows -
  2837.         REMOTE options" for details.
  2838.  
  2839.  
  2840.     YU - Upload a binary file using pP or YAPP protocol
  2841.  
  2842.         This operation is an Upload from the remote operator's point of
  2843.         view: a binary file is being sent to our system from the other
  2844.         station using either pP (paKet Protocol) or YAPP protocol.
  2845.  
  2846.         That file will be stored in our Binary Recv directory (specified
  2847.         in Configuration Windows - File/Directories). For your protection,
  2848.         paKet will not allow the remote operator to specify a drive or
  2849.         directory.
  2850.  
  2851.                                Page 136
  2852.  
  2853.         It is not necessary for the remote operator to enter the filename
  2854.         with the YU command because that information is included in the
  2855.         Protocol Header.
  2856.  
  2857.         paKet will:
  2858.               set up the necessary parameters in the TNC;
  2859.               display the Binary File Transfer Window;
  2860.               synchronise with the other station; then
  2861.               begin the transfer.
  2862.  
  2863.         When the transfer is complete, paKet will return to REMOTE Mode
  2864.         and the Menu will be reissued to the other station.
  2865.  
  2866.         Refer to the section on the Binary File Transfer Window for
  2867.         details of the display and also refer to the "Keyboard Commands"
  2868.         section of this Manual, where the discussion on the <F8> key
  2869.         provides some more detail on receiving a Binary File.
  2870.  
  2871.  
  2872.         If you do not want another station to transfer any files to this
  2873.         system you can disable this option. Refer to "Configuration
  2874.         Windows - REMOTE options" for details.
  2875.  
  2876.  
  2877.    YW - What files are available in the Binary Send Directory
  2878.  
  2879.         If the remote operator sends a "YW" command, paKet REMOTE will
  2880.         send a sorted list of filenames found in our Binary Send
  2881.         directory, including the directory names of any sub directories
  2882.         found in that Binary Send directory.
  2883.  
  2884.         The available space on that drive will be sent. If our Binary Send
  2885.         and Binary Recv directories are on different drives, the available
  2886.         space on the Binary Recv drive will also be sent.
  2887.  
  2888.         If the remote operator wants to see a directory listing of one of
  2889.         the sub directories, the desired directory name must be entered
  2890.         with the YW command. For example, using the sample directory tree
  2891.         shown in the REMOTE D (Download) command above, and assuming you
  2892.         have specified C:\PAKET\BIN\ as the Binary Send Directory, suppose
  2893.         the remote operator wanted a listing of our GAMES directory. The
  2894.         following command would be required:
  2895.            YW GAMES
  2896.  
  2897.         Refer to the REMOTE D command for a full discussion on the use of
  2898.         sub directories.
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.                                Page 137
  2914.  
  2915. Messages (A to L)
  2916.  
  2917.  This is a list of messages sent by the paKet REMOTE system to the other
  2918.  station. They are listed in alphabetic order.
  2919.  
  2920.  
  2921.  999,999 bytes free
  2922.  (The upload directory is on another drive - 999,999 bytes free there)
  2923.  
  2924.     Another station is using our REMOTE mode and has requested a directory
  2925.     display from our system. The directory that will be shown is the
  2926.     Download directory, i.e. the directory of files that may be
  2927.     transferred FROM our system.
  2928.  
  2929.     When the file details are sent, the first of these two messages will
  2930.     be added to show the other station how much free space we currently
  2931.     have on the drive.
  2932.  
  2933.     If the drive specified for our Upload directory (i.e. the drive used
  2934.     for files transferred TO our system) happens to be a different drive,
  2935.     the second of these messages is also sent.
  2936.  
  2937.  
  2938.  A disk error has occurred here.
  2939.  
  2940.     This message is a general catch all for various types of file errors
  2941.     that occur during some REMOTE mode operation. The message will be sent
  2942.     to the other station when/if such a condition occurs. It will usually
  2943.     be accompanied by other messages to better define the nature of the
  2944.     problem, so be guided by the other messages for a course of action.
  2945.  
  2946.  
  2947.  BaycoM command must be MW, MD or MU.
  2948.  
  2949.     Another station is using our REMOTE mode and entered a command
  2950.     beginning with "M" but the command we received is not one of the valid
  2951.     BayCom commands.
  2952.  
  2953.     That command is rejected and the above message is returned to the
  2954.     other station.
  2955.  
  2956.  
  2957.  File display not available. Sorry.
  2958.  
  2959.     A station is using our REMOTE mode and has requested a directory
  2960.     display from our system, but we are unable to prepare the list to send.
  2961.  
  2962.     When a directory listing is requested, paKet will go through the
  2963.     following steps:
  2964.        1. read the requested directory into memory;
  2965.        2. sort it into alphabetic sequence (by name);
  2966.        3. write all that to a temporary file;
  2967.        4. send that temporary file to the other station;
  2968.        5. delete the temporary file when it has been sent.
  2969.  
  2970.     If something trips up in any of these steps, the display will not be
  2971.     available. Typically the cause of such a problem would be related to a
  2972.     lack on memory to perform the load and sort operations, or a lack of
  2973.     disk space to create the temporary file.
  2974.  
  2975.                                Page 138
  2976.  
  2977.     When this message is returned to the other station, the REMOTE Menu
  2978.     should be issued again and processing continues normally.
  2979.  
  2980.  
  2981.  File path is ignored (I will use the file NAME).
  2982.  
  2983.     Another station is using our REMOTE mode and has attempted to send a
  2984.     file to our system, but has specified a Drive and/or Directory in
  2985.     addition to the file name.
  2986.  
  2987.     I have decided to restrict uploads to our system to a single directory
  2988.     so it is clear to you what may have been uploaded in your absence and
  2989.     to contain the possibility of a virus-ridden program being loaded into
  2990.     a working directory.
  2991.  
  2992.     The above message is issued to the other station for information but
  2993.     the file transfer will continue. The file will be loaded into the
  2994.     directory you have specified in your Configuration.
  2995.  
  2996.  
  2997.  I can't create a new PMS DataBase!
  2998.  I'll try again next time.
  2999.  
  3000.     paKet was attempting to perform some housekeeping on the PMS database,
  3001.     removing any deleted messages to conserve space on the disk. However,
  3002.     it is unable to create a new copy of the database file. The cause
  3003.     could be something as simple as a lack of disk space.
  3004.  
  3005.     Housekeeping can wait till next time so it is a non-critical error (as
  3006.     far as the PMS is concerned anyway).
  3007.  
  3008.     This message warns you of the error but then processing continues
  3009.     normally.
  3010.  
  3011.  
  3012.  I can't read the message file.
  3013.  Ask (yourname) to investigate the cause
  3014.  
  3015.     Someone is trying to read a message from our PMS but paKet is unable
  3016.     to access the database for some reason.
  3017.  
  3018.     This message gives the bad news to the user.
  3019.  
  3020.     The PMS file is either missing or corrupted. If it has been corrupted
  3021.     you might have to delete it (losing any messages that were stored
  3022.     there) and allow paKet to start afresh next time it is loaded.
  3023.  
  3024.  
  3025.  I don't handle Bulletins so I'll treat this as a Personal message.
  3026.  
  3027.     Someone has entered an "SB" command to our PMS.
  3028.  
  3029.     This is the usual way to enter a Bulletin into a BBS system, but paKet
  3030.     does not handle Bulletins. It does not perform outward message
  3031.     forwarding so there is little point in processing Bulletins.
  3032.  
  3033.     This message will be stored as a personal message but unless it is
  3034.     addressed to "ALL", no-one else will be able to read it! Of course you
  3035.     have access to any message in this system, but noone else (other than
  3036.     the station who sent the message) will be able to read it.
  3037.                                Page 139
  3038.  
  3039.  
  3040.  
  3041.  I have a disk error and cannot record the message.
  3042.  Ask (yourname) to investigate the cause.
  3043.  
  3044.     A disk error has occurred while paKet is attempting to write to the
  3045.     PMS files.
  3046.  
  3047.     This message will be sent to the other station who is trying to leave
  3048.     a message in our PMS.  The message has not been stored.
  3049.  
  3050.  
  3051.  I need the file name and the file size.
  3052.  Eg: MU PROG.COM,14392
  3053.  Enter zero for the filesize if you don't know it's size in bytes.
  3054.  
  3055.     Another station (probably a BayCom user) is using our REMOTE mode and
  3056.     has attempted to send a Binary file to our system with the MU command
  3057.     but has not specified the command correctly.
  3058.  
  3059.     As the BayCom system does not (yet?) have a file transfer protocol to
  3060.     indicate when the transfer is complete, paKet needs to know when to
  3061.     close the file.  So, if it knows how many bytes are in the file, it
  3062.     will close the file when the specified number of bytes have been
  3063.     received.
  3064.  
  3065.     If the other station has not specified the file size, the MU command
  3066.     will be rejected with the above message. If that station does not
  3067.     happen to know the exact size of the file, a zero filesize may be
  3068.     specified to tell paKet to wait for the file to be closed manually.
  3069.  
  3070.  
  3071.  *** Invalid option
  3072.  
  3073.     A station is connected to our REMOTE Menu system but has entered what
  3074.     looks like an invalid command. The available commands are those
  3075.     appearing in the REMOTE Menu. Anything else is considered invalid and
  3076.     will cause this message to be issued.
  3077.  
  3078.     It is possible to get lots of these all at once if say, a file
  3079.     transfer has gone out of control and our REMOTE system keeps receiving
  3080.     parts of the file when we are really expecting to get just a valid
  3081.     Menu command! To avoid sending too many unwanted "Invalid option"
  3082.     messages, paKet will shut down the REMOTE processing and will issue
  3083.     the "REMOTE mode cancelled" message if there are several consecutive
  3084.     errors.
  3085.  
  3086.  
  3087.  Leaving the menu...now communicating with (yourname), the paKet operator.
  3088.  
  3089.     This message is sent to another station, who was using our REMOTE
  3090.     mode, when you press the <F3> key to switch off REMOTE Mode.
  3091.  
  3092.     You are now in normal communications mode.
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.                                Page 140
  3100.  
  3101.  Leaving REMOTE mode - returning to Normal Communications.
  3102.  I'll ring the bell. If no response soon, maybe (yourname) is not around?
  3103.  
  3104.     Another station was using our REMOTE mode and has entered a "T" (Talk)
  3105.     command to cancel the REMOTE menu so personal interactive communications
  3106.     may be conducted.
  3107.  
  3108.     paKet will now be in normal communications mode.
  3109.  
  3110.     The "telephone" bell will be sounded to alert you, because it is
  3111.     possible you are close by but not aware the other station wants to
  3112.     talk to you.  The bell will stop ringing at your first keystroke, but
  3113.     if you are not present it will stop after 10 rings.
  3114.  
  3115.  
  3116.  Logged off...
  3117.  
  3118.     Another station was using our REMOTE system and has now issued the Bye
  3119.     command to terminate the session.
  3120.  
  3121.     This message is sent to that other station before paKet issues the
  3122.     Disconnect command to your TNC.
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.                                Page 141
  3162.  
  3163. Messages (M to R)
  3164.  Message 4 Killed
  3165.  
  3166.     Someone has killed a message from our PMS and this message is issued
  3167.     to confirm the success of the operation.
  3168.  
  3169.  
  3170.  Message 4 stored
  3171.  
  3172.     Someone has just left a message in our PMS. This message is issued by
  3173.     paKet to confirm the message has been successfully written to disk.
  3174.  
  3175.  
  3176.  Msg#  Size To         From       Date   Time  Subject
  3177.  
  3178.     When paKet displays a List of available messages in our PMS, it will
  3179.     display the above headings so the user can better identify the various
  3180.     parts of the information given.
  3181.  
  3182.     Details of the message format are listed in full in the PMS section of
  3183.     this Manual.
  3184.  
  3185.  
  3186.  (No files)
  3187.  
  3188.     Another station is using our REMOTE Mode and has requested a directory
  3189.     display with a W, YW or MW command. If paKet finds the requested
  3190.     directory empty it will return this brief message to the other station.
  3191.  
  3192.  
  3193.  No further Information available. Sorry.
  3194.  
  3195.     Another station is using our REMOTE mode and has asked for further
  3196.     information on our system by entering the "I" command.
  3197.  
  3198.     paKet provides this information by sending the file REMOTE.INF, but if
  3199.     that file cannot be found the above message will be sent instead.
  3200.  
  3201.  
  3202.  No HELP available. Sorry.
  3203.  
  3204.     Another station is using our REMOTE mode and has asked for Help by
  3205.     entering "H" or "?".
  3206.  
  3207.     paKet provides this help by sending the file REMOTE.HLP, but if that
  3208.     file cannot be found the above message will be sent instead.
  3209.  
  3210.  
  3211.  Now I can't find that message
  3212.  
  3213.    Something is badly wrong if you see this message.  I haven't seen it
  3214.    yet, and if YOU do, it means there is a program bug, and I'd really
  3215.    like to know exactly what you did to make it happen!
  3216.  
  3217.  
  3218.  Now I can't read the PMS DataBase file!
  3219.  
  3220.     Something has just happened to the PMS database. We had been using it
  3221.     but now it is unreadable.  This message is most likely caused by a
  3222.     genuine disk error, so I hope you never see it!
  3223.                                Page 142
  3224.  
  3225.  
  3226.  
  3227.  OK, send your message...(Ctrl-Z to end)
  3228.  
  3229.     When someone is leaving a message in our PMS, paKet will ask for the
  3230.     Subject of the message and then will issue this prompt to let the user
  3231.     know it is ready to accept the message and to remind that station to
  3232.     enter the <Ctrl-Z> to terminate the message. (A disconnect will also
  3233.     terminate the message, but that's real messy, so we won't tell them
  3234.     about that!)
  3235.  
  3236.  
  3237.  Please include the filename with the command.
  3238.  
  3239.     Another station is using our REMOTE mode and has requested a file
  3240.     transfer from our system, but has not told us which file to transfer.
  3241.  
  3242.     This message is sent to that other station to ask for the command to
  3243.     be reentered with the desired filename.
  3244.  
  3245.  
  3246.  Ready to receive ASCII text file...(Ctrl-Z to end)
  3247.  
  3248.     Another station is using our REMOTE mode and has commenced an ASCII
  3249.     text file transfer to our system.
  3250.  
  3251.     This message is issued to let the other user know we are ready to
  3252.     receive and to remind them we need the <Ctrl-Z> to close the file.
  3253.  
  3254.     (If you are present, you could close the file manually by pressing the
  3255.     <F6> key at any time).
  3256.  
  3257.  
  3258.  Ready to receive binary file using paKet Protocol...
  3259.  Ready to receive binary file using YAPP protocol...
  3260.  Ready to send binary file using paKet Protocol...
  3261.  Ready to send binary file using YAPP protocol...
  3262.  
  3263.     Another station is using our REMOTE mode and has commenced a Binary
  3264.     File Transfer to or from our system.
  3265.  
  3266.     When paKet is ready to proceed, it will issue one of the above
  3267.     messages to the other station. The message sent depends on whether you
  3268.     have enabled paKet Protocol in your Configuration.
  3269.  
  3270.     There is a full discussion on paKet Protocol in its own section of the
  3271.     manual but it is fully compatible with the YAPP protocol so don't be
  3272.     concerned if it says "paKet Protocol" when you are communicating with
  3273.     a YAPP station.   paKet will automatically detect the presence of
  3274.     another paKet Protocol station and will use the advanced protocol as
  3275.     appropriate.
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.                                Page 143
  3286.  
  3287.  REMOTE mode cancelled
  3288.  
  3289.     Another station is connected and was using our REMOTE Menu, but
  3290.     something has happened (for example, too many "Invalid option"
  3291.     messages) and paKet has decided to shut down the REMOTE processing
  3292.     rather than continually flood the frequency with these "Invalid
  3293.     option" messages.
  3294.  
  3295.     The other station is informed of this action with the above message.
  3296.  
  3297.     paKet resumes in normal communications mode.
  3298.  
  3299.  
  3300.  REMOTE operations disabled, sorry.
  3301.  
  3302.     Another station has attempted to trigger our REMOTE mode by entering
  3303.     the character you have configured as the REMOTE Trigger.
  3304.  
  3305.     However you currently have disabled REMOTE mode so paKet will refuse
  3306.     the other station's request and will send this message to let them
  3307.     know the situation here.
  3308.  
  3309.  
  3310.  Returning to normal communications...
  3311.  
  3312.     You have access to the PMS via the <Alt-M> (Message) key. When you
  3313.     press this key, paKet responds with a Sysop PMS Menu to provide access
  3314.     to various PMS operations. When you are finished with the PMS and have
  3315.     pressed B (Bye) paKet closes the PMS and issues this message to
  3316.     confirm that operations are now back to normal communications mode.
  3317.  
  3318.  
  3319.  
  3320.  
  3321.  
  3322.  
  3323.  
  3324.  
  3325.  
  3326.  
  3327.  
  3328.  
  3329.  
  3330.  
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.  
  3347.                                Page 144
  3348.  
  3349. Messages (S to Z)
  3350.  
  3351.  Someone else is connected to another stream.
  3352.  I cannot (yet?) handle multiple REMOTE operations.
  3353.  
  3354.     This error message:
  3355.       a. appears in a popup Message Window if you have pressed <F3> to put
  3356.          paKet into REMOTE mode when there is more than one station
  3357.          currently connected.
  3358.  
  3359.          Try it again later when you have only one station connected.
  3360.  
  3361.       b. will be sent to another station if that station sends the REMOTE
  3362.          Trigger in an attempt to activate our REMOTE menu while someone
  3363.          else is connected on another of our streams.
  3364.  
  3365.          The REMOTE Trigger will not be processed and the system will
  3366.          remain in normal communications mode.
  3367.  
  3368.  
  3369.  Someone is already connected and using REMOTE mode.
  3370.  Please try again later.
  3371.  
  3372.     This message will be sent to a station who connects to our system at a
  3373.     time when some other station is already using our REMOTE mode.
  3374.  
  3375.     In this version of paKet, REMOTE mode processing requires exclusive
  3376.     use of the system. So, when this message is sent, paKet will issue a
  3377.     Disconnect command to the TNC.
  3378.  
  3379.  
  3380.  Sorry, but this station does not accept Uploads
  3381.  
  3382.     Another station is using our REMOTE mode and has attempted to send a
  3383.     file to our system.
  3384.  
  3385.     This message will be sent to that other station if you have specified
  3386.     in your Configuration that you do not wish to allow REMOTE Uploads.
  3387.  
  3388.  
  3389.  Sorry, but this station does not allow Downloads
  3390.  
  3391.     Another station is using our REMOTE mode and has requested a file
  3392.     transfer from our system.
  3393.  
  3394.     This message will be sent to that other station if you have specified
  3395.     in your Configuration that you do not wish to allow REMOTE Downloads.
  3396.  
  3397.  
  3398.  Subject for msg 4 (max 30 characters)
  3399.  
  3400.     When a message is entered into our PMS, paket will prompt the user for
  3401.     the Subject of the message. This "subject" is limited to 30 characters
  3402.     so it will fit on the line when the user displays a List of the
  3403.     available messages.
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.                                Page 145
  3410.  
  3411.  That directory is not available. Sorry.
  3412.  
  3413.     Another station is using our REMOTE mode and has requested a directory
  3414.     display from our system, but it appears the directory specified is not
  3415.     one of ours (probably misspelt)!
  3416.  
  3417.     This message is sent to the other station, followed by the REMOTE Menu
  3418.     so they can try again.
  3419.  
  3420.  
  3421.  The YU command is sufficient - there is no need to specify a file name.
  3422.  
  3423.     Another station is using our REMOTE mode and has commenced a Binary
  3424.     File Transfer to our system using the YU command, but the other user
  3425.     has specified a filename on the command line.
  3426.  
  3427.     Some other YAPP-compatible systems require the filename (as the YAPP
  3428.     file header is optional and may not necessarily be sent) but paKet
  3429.     expects to extract the filename from the YAPP protocol header. This
  3430.     message is issued to let the other user know a few keystrokes could be
  3431.     saved next time.
  3432.  
  3433.  
  3434.  This file already exists. Sorry.
  3435.  
  3436.     This message is sent to another station if that station has attempted
  3437.     to send a Text file which already exists in our Text Upload directory.
  3438.  
  3439.     The REMOTE menu will be reissued so that user can try again with a
  3440.     different filename.
  3441.  
  3442.  
  3443.  To leave a message for a particular station, enter 'S (callsign)
  3444.  Note the <space> after the 'S'. Eg: S VK2DHU
  3445.  
  3446.     Someone has entered a command beginning with S but it is not a valid
  3447.     Send command. This message is issued to help the user with the
  3448.     required syntax.
  3449.  
  3450.  
  3451.  Without the filesize I wont know when the transfer is finished
  3452.  So, when your system has finished sending the file, type the following:
  3453.  <CR>//WPRG OFF<CR>
  3454.  (the <CR> is the Enter key).
  3455.  When I receive that I'll close the file; then I'll send the Menu again.
  3456.  
  3457.     The above series of messages is sent to the other station (probably a
  3458.     BayCom user) when that operator is sending a Binary File to our REMOTE
  3459.     system (using the MU command) and that user has given us a file size
  3460.     of zero.
  3461.  
  3462.  
  3463.  YAPP command must be YW, YD or YU.
  3464.  
  3465.     Another station is using our REMOTE mode and entered a command
  3466.     beginning with "Y" but the command we received is not one of the valid
  3467.     YAPP commands.
  3468.  
  3469.     That command is rejected and the above message is returned to the
  3470.     other station.
  3471.                                Page 146
  3472.  
  3473.  
  3474.  
  3475.  You are already connected to REMOTE.
  3476.  
  3477.     This message will be sent to the other station if that user sends the
  3478.     REMOTE Trigger when we are already in REMOTE mode.
  3479.  
  3480.     No action required and no harm done.
  3481.  
  3482.  
  3483.  You are not allowed access to that message
  3484.  
  3485.     Our PMS is a facility for REMOTE users to send (and receive) messages
  3486.     to you and to third parties. However paKet allows a user to access
  3487.     only those messages either sent BY or addressed TO that station (or to
  3488.     ALL). If the REMOTE user tries to access someone else's message, paKet
  3489.     will refuse the request, returning this warning message.
  3490.  
  3491.  
  3492.  You have mail waiting in my PMS
  3493.  Check it out with the List and Read (and Kill) menu commands
  3494.  
  3495.     This message is sent to another station who has just connected to our
  3496.     system if paKet finds at least one message addressed to this station
  3497.     in our PMS.
  3498.  
  3499.     paKet does not note whether a message has been read, so this reminder
  3500.     will be sent every time that user connects to us if the message is not
  3501.     removed from the PMS.
  3502.  
  3503.  
  3504.  You may specify a DIRECTORY if necessary, but a DRIVE is NOT permitted
  3505.  
  3506.     Another station is using our REMOTE mode and has requested a file
  3507.     transfer from our system, but has specified a DRIVE for the requested
  3508.     file.
  3509.  
  3510.     This is not permitted so their command is rejected with this message.
  3511.  
  3512.  
  3513.  You must specify the other station's callsign.
  3514.  
  3515.     When you are entering a message into the PMS from the Sysop PMS menu
  3516.     you must enter the callsign of the station the message is intended for.
  3517.  
  3518.     When another user is connected to our PMS, the callsign is optional
  3519.     because paKet will simply assume they are sending the message to you
  3520.     and will insert your callsign into the "To" field of the message.
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.  
  3530.  
  3531.  
  3532.  
  3533.                                Page 147
  3534.  
  3535.  
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.  
  3543.  
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.  
  3560.  
  3561.  
  3562.  
  3563.  
  3564.  
  3565.                         (This page intentionally blank)
  3566.  
  3567.  
  3568.  
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.  
  3591.  
  3592.  
  3593.  
  3594.  
  3595.                                Page 148
  3596.  
  3597. PART VII - SCRIPT PROCESSING
  3598.  
  3599. Overview
  3600.  
  3601.    paKet includes a simple Script processing facility. The key word there
  3602.    is "simple".
  3603.  
  3604.    This facility offers some degree of automation providing a number of
  3605.    Script commands for flexibility in setting up a wide range of Script
  3606.    processes. However I must emphasise that because this is a SIMPLE
  3607.    facility, it is your responsibility to get it right. There is very
  3608.    little error checking performed but if paKet detects something strange
  3609.    the Script processing will be aborted.
  3610.  
  3611.    However, on a more positive note, it could be useful for regular,
  3612.    routine operations such as logging on to your BBS, reading your mail,
  3613.    checking the latest bulletins, or a file transfer. A sample Script file
  3614.    to do some of these things is given below.
  3615.  
  3616.    It is possible to write a Script with an appropriate delay to allow the
  3617.    processing to wait until a specified time before continuing. So,
  3618.    conceivably, before going to bed you could start a Script to (for
  3619.    example) wait until 2am, logon to the local BBS, download a Binary
  3620.    File, and log off.
  3621.  
  3622.    The Script facility should be sufficiently flexible to allow a variety
  3623.    of operations, given a little imagination. So if you do develop a
  3624.    "good" Script file of your own, why not spread it around? Broadcast it
  3625.    to other users (I suggest a Bulletin addressed to PAKET or perhaps to
  3626.    IBM rather than to ALL would attract the attention of paKet users). I
  3627.    would appreciate it if you could let me have a copy too.
  3628.  
  3629.  
  3630.  Running a Script File.
  3631.  
  3632.    Press <Alt-S> to commence Script Processing.
  3633.  
  3634.    A Directory Window will appear with the default Script file name
  3635.    already highlighted. If you decide to enter a file name manually and
  3636.    you type a file name without an extension, paKet will assume an
  3637.    extension of ".SCP" so it is recommended you use an extension of .SCP
  3638.    for all your Script files.
  3639.  
  3640.    When you select the desired Script file, that file will be loaded and
  3641.    Script processing will commence.   The word "SCRIPT" will be displayed
  3642.    in the Status Window to the left of the time display while the Script
  3643.    is running.
  3644.  
  3645.    When the Script has completed, the indicator in the Status Window will
  3646.    disappear and you will be returned to normal communications.
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.                                Page 149
  3658.  
  3659. Script Commands
  3660.  
  3661.    The following Script commands are valid:
  3662.  
  3663.    : label            No processing is performed on this line.
  3664.                       It is used by the Goto command.
  3665.  
  3666.                       As no processing is performed here, this could also
  3667.                       be used as a comment in your Script file.
  3668.  
  3669.                       "label" may be any length but the total line length
  3670.                       must be less than 80 chars.
  3671.  
  3672.    AC                 Close the Download file.
  3673.                       Presumably this will follow the AD command somewhere
  3674.                       in your Script?
  3675.  
  3676.                       If the file is already closed, this command will be
  3677.                       ignored.
  3678.  
  3679.    AD filename        ASCII File download
  3680.                       (Same as <F6> but you must put filename on the
  3681.                       Script command line. (Eg: AD RECVFILE.DAT)  Note
  3682.                       that like <F6> if the file already exists, a new one
  3683.                       will be created with a sequential numeric extension
  3684.                       (RECVFILE.000 or RECVFILE.001 etc).
  3685.  
  3686.    AU filename        ASCII file Upload.
  3687.                       Same as <F5> but again you specify the filename in
  3688.                       the Script command line. (Eg: AU SENDFILE.DAT).
  3689.  
  3690.    B                  Send a BREAK (or <Ctrl-C>) to the Serial Port.
  3691.                       (Same as <Alt-B> - return to cmd: mode)
  3692.  
  3693.    C script_file      Call another Script.
  3694.  
  3695.                       A Script file is limited to a maximum of 200 lines,
  3696.                       but if you find this limiting your style, you can
  3697.                       set up a number of Scripts and Call them as
  3698.                       required. Yep, paKet even includes Structured
  3699.                       Programming!
  3700.  
  3701.                       There is no practical limit to the number of nested
  3702.                       Scripts you may call. Each of the called Scripts
  3703.                       should "Return" to the calling Script, in which case
  3704.                       processing of THIS Script will continue with the
  3705.                       command following this Call command.  Note the
  3706.                       facility for "flags" to return the status of
  3707.                       important events while in the called file.
  3708.  
  3709.    D time             Delay for "time" seconds, or delay until hh:mm.
  3710.      or               "time" may be 1 to 32767 seconds (about 9 hours).
  3711.    D hh:mm            "hh:mm" is a time of day. If this format is used,
  3712.                       paKet will wait until that time occurs before
  3713.                       continuing. Note, this time may be earlier than the
  3714.                       current time, in which case the system will wait
  3715.                       until that time arrives TOMORROW before continuing.
  3716.  
  3717.  
  3718.  
  3719.                                Page 150
  3720.  
  3721.    E text             Echo text to the screen.
  3722.                       This is included mainly as a form of documentation
  3723.                       within the Script. The text is echoed to the screen
  3724.                       as if it was received from the other station, so it
  3725.                       will appear in your log file if it is active.
  3726.  
  3727.  
  3728.    FC n               Flag Clear
  3729.    FS n               Flag Set
  3730.    FT n               Flag Test
  3731.                       There are 10 flags available within the Script
  3732.                       system.
  3733.  
  3734.                       These are Binary flags (i.e either ON or OFF)
  3735.                       numbered 0 through to 9 and may be used by the
  3736.                       Script Programmer (that's YOU).
  3737.  
  3738.                       It was found by a paKet/Script user that there are
  3739.                       times when you need to remember the status of some
  3740.                       condition during the Script process.  By setting one
  3741.                       (or more) of the flags you can test the status of
  3742.                       that flag later in the Script and adjust the
  3743.                       processing as required.
  3744.  
  3745.                       For example you might need to note the fact that a
  3746.                       particular string was received from the TNC (using
  3747.                       the "W" command). When that string was received you
  3748.                       could Set a flag with the Flag Set Command,
  3749.                       (eg) "FS 4".
  3750.  
  3751.                       Later during this Script you could check the status
  3752.                       of that flag with the Flag Test command (eg) "FT 4".
  3753.                       If the flag is set, the next Script command is
  3754.                       performed, but if the tested flag is not Set (or
  3755.                       Clear) the next line in the Script is skipped.
  3756.  
  3757.  
  3758.    G label            Goto "label" and continue the Script from there.
  3759.                       (Yeah, yeah I know Goto is unfashionable!)
  3760.  
  3761.    L                  Disk Log File On/Off toggle
  3762.                       This uses the default log filename.
  3763.  
  3764.    P                  Printer Log On/Off toggle.
  3765.  
  3766.    Q                  Quit.
  3767.                       The Script processing is terminated. This would be
  3768.                       used for an aborted exit.
  3769.  
  3770.                       The Return command is a tidier way to exit a Script.
  3771.  
  3772.    R                  Return
  3773.                       This command is especially used to return control to
  3774.                       a calling Script. If used in the first level, or
  3775.                       only Script, Script processing is terminated and
  3776.                       control is returned to paKet.  Note the facility for
  3777.                       "flags" to return the status of important events
  3778.                       while in the called file.
  3779.  
  3780.                       A Return will be assumed at the end of a Script file.
  3781.                                Page 151
  3782.  
  3783.  
  3784.    S text             Send "text" to the TNC.
  3785.                       If you want to include a Control character such as
  3786.                       <Ctrl-C>, or an <Alt- > key combination such as
  3787.                       <Alt-A>, refer to the Special Key Codes section of
  3788.                       this Manual for the special syntax. Do not enter
  3789.                       quotes unless you want them sent to the TNC.
  3790.  
  3791.  
  3792.  
  3793.                       A Carriage Return is generated automatically when
  3794.                       "text" has been sent. Note, if you do not want the
  3795.                       <CR> to be sent, add a caret ('^') as the last
  3796.                       character of the text.  paKet will then NOT generate
  3797.                       the <CR>. (It won't send that final caret either!)
  3798.  
  3799.    T label,string     Trap -  Goto 'label' if 'string' is received.
  3800.                       If 'string' is received at any time during this
  3801.                       Script, processing will continue from the nominated
  3802.                       'label'.  Note that this happens even if a "Delay"
  3803.                       or "Wait" instruction is in progress.
  3804.  
  3805.                       For example, say your Script includes the following
  3806.                       commands:
  3807.                          T MSG,Message waiting
  3808.                          T DONE,No Messages Available
  3809.  
  3810.                       Then, if the string "Message waiting" is received
  3811.                       from the TNC at any time during the processing of
  3812.                       this Script, paKet will detect the matching Trap
  3813.                       string and will continue processing from the MSG
  3814.                       label.
  3815.  
  3816.                       And if the string "No Messages Available" is
  3817.                       received at any time during the Script, processing
  3818.                       continues from the DONE label.
  3819.  
  3820.                       The Trap remains set even if nested Scripts are
  3821.                       CALLed, so 'label' must be a defined label within
  3822.                       all Scripts if the Trap is to be effective.
  3823.  
  3824.                       If a Trap is no longer required, it may be disabled
  3825.                       by specifying the command without a string. Eg:
  3826.                          T DONE,
  3827.                       (Note the comma is still required here).
  3828.  
  3829.                       Up to 30 Trap strings may be current at any one time.
  3830.  
  3831.    W time,string      Wait up to "time" seconds for "string" to be
  3832.                       received from the TNC.
  3833.  
  3834.                       The received "string" need not start at the
  3835.                       beginning of the line.
  3836.  
  3837.                       If "string" is received within the specified "time"
  3838.                       the next line of the Script file is skipped,
  3839.                       otherwise the next line is executed.
  3840.  
  3841.                       Do not enter quotes in "string" unless you are
  3842.                       expecting them in the received text.
  3843.                                Page 152
  3844.  
  3845.  
  3846.    X                  Exit the paKet program.
  3847.                       This should be used with care. It will not only shut
  3848.                       down the Script, it will also shut down the paKet
  3849.                       program and will return to DOS.
  3850.  
  3851.  
  3852.    YD                 Commence a Binary File download.
  3853.                       This assumes the other station is now waiting to
  3854.                       send a Binary File to us with either pP or YAPP
  3855.                       protocol.
  3856.  
  3857.  
  3858.    YU filename        Commence a Binary File upload.
  3859.                       This assumes the other station is now waiting to
  3860.                       receive a file with either pP or YAPP protocol.
  3861.  
  3862.                       'filename' must include full path details unless it
  3863.                       is in the current directory.
  3864.  
  3865.    ! dos_command      Run a DOS command.
  3866.                       This will load a copy of COMMAND.COM and will pass
  3867.                       'dos_command' to DOS for processing. When that DOS
  3868.                       command/program has finished, processing of the
  3869.                       Script will continue from the next line in the
  3870.                       Script.
  3871.  
  3872.                       The comments I made for the <F9> key and for the
  3873.                       <Alt-E> in the "Keyboard Commands" section of this
  3874.                       Manual apply here too. You will not have the usual
  3875.                       amount of memory available for these DOS commands
  3876.                       because paKet is still running and still occupying a
  3877.                       lot of your precious memory.
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.  
  3904.  
  3905.                                Page 153
  3906.  
  3907. The Script File syntax.
  3908.  
  3909.  The rules:-
  3910.       1. The Script file is plain ASCII text
  3911.          (graphic characters > $128 allowed).
  3912.       2. All lines must be less than 80 characters.
  3913.       3. Each Script file is limited to a maximum of 200 lines.
  3914.          (Use the CALL command to CALL other Scripts if you need more).
  3915.  
  3916.  All spaces will be ignored, except for EMBEDDED spaces in "text" (in the
  3917.  Send command) and "string" (in the Wait command) - LEADING spaces in
  3918.  "text" and "string" will be ignored. For example:
  3919.  
  3920.       s YU PROG.EXE
  3921.       W 10, Ready to Receive with YAPP protocol
  3922.       g notready
  3923.       y u prog.exe
  3924.  
  3925.  is identical to:
  3926.  
  3927.       SYU PROG.EXE
  3928.       W10,Ready to Receive with YAPP protocol
  3929.       GNOTREADY
  3930.       YUPROG.EXE
  3931.  
  3932.  
  3933.  You are the "programmer" here so choose a style that suits you best.
  3934.  Most people would find the latter example more difficult to read.  The
  3935.  careful use of spaces makes for more easily understood programming, which
  3936.  probably means fewer logic problems in your Scripts.
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942. Other uses for Scripts:
  3943.  
  3944.   Once you start using this Script facility, you will find the ideas will
  3945.   just keep coming. Here are just a couple of thoughts to illustrate:
  3946.  
  3947.   Run a Script file that Traps on the "*** CONNECTED to xxxxxx" message for
  3948.   each of your favourite operators, sends them a personal greeting like
  3949.   BayCom or Digicom does, waits if necessary and invokes REMOTE Mode if
  3950.   appropriate for that particular operator.
  3951.  
  3952.   Most of the functions of a PMS can be emulated; certainly the "YU", "YD",
  3953.   "U", "D", "S", but for selected parameters only.
  3954.  
  3955.   You may wonder how a Directory listing could be sent?  It could be
  3956.   performed by an exit to DOS which performs the directory listing and
  3957.   "pipes" it to a temporary file which is sent (AU Script command).
  3958.  
  3959.   What about a MHEARD listing?  This could be performed by opening a
  3960.   Receive file (AD Script command) then issuing the "MHEARD" command and
  3961.   closing the file (AC command) when the cmd: prompt is received again.
  3962.   That file would then be Sent (AU Script command) to the other station.
  3963.  
  3964.   And so on.
  3965.  
  3966.  
  3967.                                Page 154
  3968.  
  3969. A Sample Script
  3970.  
  3971.  A sample Script file.
  3972.  
  3973.   : A sample paKet Script to download a file using YAPP protocol
  3974.   g start
  3975.   : TRYAGAIN
  3976.   d 1800
  3977.   : START
  3978.   b
  3979.   s
  3980.   w 10,cmd:
  3981.   g GIVEUP
  3982.   s c vk2atm-1
  3983.   w 60,PBBS>
  3984.   g TRYAGAIN
  3985.   l
  3986.   s rm
  3987.   w 120,PBBS>
  3988.   g Disklogoff
  3989.   l
  3990.   s yd prog.exe
  3991.   w 30,Ready to Send with YAPP protocol
  3992.   g GIVEUP
  3993.   yd
  3994.   d 5
  3995.   s B
  3996.   R
  3997.   :Disklogoff
  3998.   l
  3999.   : giveup
  4000.   b
  4001.   w 10,cmd:
  4002.   g END
  4003.   s D
  4004.   :end
  4005.   r
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.  
  4026.  
  4027.  
  4028.  
  4029.                                Page 155
  4030.  
  4031.  Discussion on the Sample Script:
  4032.  
  4033.  The first line is a comment.
  4034.  
  4035.  paKet does a Goto to the ":START" label, avoiding the half hour delay the
  4036.  first time around.
  4037.  
  4038.  A BREAK signal is sent to ensure the TNC is in Command mode, then an
  4039.  "empty" Send line which simply sends a <CR> in case the TNC is already in
  4040.  Command Mode.
  4041.  
  4042.  If the string "cmd:" is not received within 10 seconds, processing
  4043.  continues from the GIVEUP label where paKet sends another BREAK signal
  4044.  and a Disconnect command before Returning to normal processing.
  4045.  
  4046.  If the prompt is received, a Connect to the local BBS (in this case
  4047.  VK2ATM-1) is attempted.
  4048.  
  4049.  If the next prompt is not received within 60 seconds, the following line
  4050.  is executed and processing will Goto TRYAGAIN where paKet will delay for
  4051.  1800 seconds (half hour) before attempting the logon again.
  4052.  
  4053.  If the "PBBS>" prompt is received, The Disk Log file is activated with
  4054.  the "L" command.
  4055.  
  4056.  paKet then sends "RM" to ask the BBS to display any mail that may be
  4057.  waiting. If the next BBS prompt is not received within 120 seconds the
  4058.  Wait will drop into the next line which is a Goto DISKLOGOFF. There the
  4059.  Disk Log file is toggled off before Disconnecting.
  4060.  
  4061.  If the "PBBS>" string is received, the "L" command toggles off the Disk
  4062.  Log file. paKet then sends "YD PROG.EXE" which is the BBS command to
  4063.  download that Binary File using pP or YAPP protocol; and waits for up to
  4064.  30 seconds for the BBS acknowledgement that it is ready to send, going to
  4065.  GIVEUP if the message is not received within that time. If the BBS is
  4066.  "Ready to Send with YAPP protocol", paKet performs the YD Script command
  4067.  which puts the program into Binary File transfer mode where the file
  4068.  transfer takes place. On completion of the file transfer, the Script
  4069.  delays for 5 seconds to allow both systems to reset parameters etc.
  4070.  
  4071.  Then it sends "B" (the BBS Bye command) to log off the BBS before
  4072.  leaving the Script with a Return to normal processing.
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.  
  4079.  
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090.  
  4091.                                Page 156
  4092.  
  4093. PART VIII - PERSONAL MESSAGE SYSTEM (PMS)
  4094.  
  4095. Overview
  4096.  
  4097.   paKet's PMS system offers message handling facilities for you and your
  4098.   REMOTE users.
  4099.  
  4100.   The operation of this PMS is similar to most other PMS systems with
  4101.   facilities for users to list available messages, leave a message, read a
  4102.   message, and delete a message, but the messages here are stored on disk.
  4103.  
  4104.   There is one major difference between this PERSONAL Message System and
  4105.   the Bulletin Board Message Systems: the current version of this PMS does
  4106.   not handle the automatic Outward Forwarding of messages.  If a message
  4107.   is entered on this PMS it stays here until someone removes it.  As there
  4108.   is no Outward Forwarding, there is little point in handling Bulletins,
  4109.   which are messages to be broadcast to other stations. However, paKet's
  4110.   PMS does allow a message to be addressed to ALL which means anyone can
  4111.   read it.
  4112.  
  4113.   Suitably programmed BBSs can however forward messages INTO the PMS.
  4114.  
  4115.   Messages in the system are allocated a message-number when they are
  4116.   entered. This message-number is retained for the life of the message.
  4117.  
  4118.   paKet's REMOTE Menu provides access to the PMS for other users. You, the
  4119.   paKet operator, have full control of the PMS via the Sysop PMS Menu
  4120.   which may be called up with the <Alt-M> key.
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.                                Page 157
  4154.  
  4155. The Sysop PMS Menu
  4156.  
  4157.    You have access to the PMS system via the Sysop PMS Menu. This menu
  4158.    appears in the Communications Window when you press <Alt-M>:
  4159.  
  4160.         Sysop PMS menu: <B,H,K,L,R,S,?>
  4161.  
  4162.    The <ScrollLock> will automatically be applied to hold any input from
  4163.    the TNC while you are using this menu. Please do not "release" it
  4164.    yourself - it will confuse the PMS processing if you do!
  4165.  
  4166.    The options in the Sysop PMS Menu are as follows:
  4167.          B (Bye)  - End Sysop PMS Processing
  4168.          H (Help) - Display these details
  4169.          K (Kill) - Kill a message (eg K 3)
  4170.          L (List) - List available messages
  4171.          R (Read) - Read a message (eg R 3)
  4172.          S (Send) - Send a message (eg S VK2XYZ)
  4173.          ? (Help) - Display these details
  4174.  
  4175.    All operations on the PMS are performed in the Communications Window so
  4176.    it will be logged if the Log File is active at the time. If you wish to
  4177.    keep a copy of any messages for future reference or further processing,
  4178.    you could activate the Log File with the <F2> key before Reading the
  4179.    messages.
  4180.  
  4181.    The 'H' command and the '?' command do the same thing which is to
  4182.    display the brief summary of the Sysop PMS Menu commands shown above.
  4183.  
  4184.    When you have finished with the PMS system, enter the B(ye) command.
  4185.    <ScrollLock> will be automatically released and you will see the
  4186.    message:
  4187.          Returning to normal communications...
  4188.  
  4189.    The other commands: K, L, R and S are shared with the REMOTE Menu which
  4190.    is where other users gain access to our PMS. Refer to the section
  4191.    "Accessing the PMS" below for detailed information on these commands.
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.  
  4209.  
  4210.  
  4211.  
  4212.  
  4213.  
  4214.  
  4215.                                Page 158
  4216.  
  4217. PMS commands in the REMOTE Menu
  4218.  
  4219.    It is via the REMOTE Menu that other users have access to our PMS. The
  4220.    REMOTE menu is discussed more fully in its own section of this Manual;
  4221.    here we are interested only in those commands relating to the PMS.
  4222.  
  4223.    The REMOTE Menu commands relating to the PMS system are K, L, R and S.
  4224.  
  4225.    A remote user may List all messages in our PMS and may Send a message
  4226.    to any other station. However they may not Read nor Kill any message
  4227.    that was not sent by or addressed to that station.
  4228.  
  4229.    (I am not sure why I bothered to restrict Read access, preventing
  4230.    remote users from reading other messages, because anyone monitoring the
  4231.    frequency can "read the mail".   It's not really private at all!
  4232.    But I wanted to prevent remote users Killing other peoples' mail so I
  4233.    applied the restriction to the Read command as well. Why not?)
  4234.  
  4235.    When another station first connects to our system, paKet will check the
  4236.    PMS and if there is any mail addressed to that station in the PMS the
  4237.    following messages will be transmitted:
  4238.  
  4239.          You have mail waiting in my PMS
  4240.          Check it out with the List and Read (and Kill) menu commands
  4241.  
  4242.     paKet does not note whether a message has been read, so this reminder
  4243.     will be sent every time that user connects to us until the message is
  4244.     Killed. This is an incentive to encourage "tidy" usage.
  4245.  
  4246.     The four commands to access the PMS (K, L, R and S) are shared with
  4247.     the Sysop PMS Menu and are discussed in the following section,
  4248.     "Accessing the PMS".
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.                                Page 159
  4278.  
  4279. Accessing the PMS
  4280.  
  4281.     There are four commands to access the PMS:
  4282.           K - Kill a message (eg K 3)
  4283.           L - List available messages
  4284.           R - Read a message (eg R 3)
  4285.           S - Send a message (eg S VK2XYZ)
  4286.  
  4287.     These commands may be issued by a remote user from the REMOTE Menu or
  4288.     may be issued by you, the paKet operator, from the Sysop PMS Menu.
  4289.     Processing is very similar for both situations so both are covered in
  4290.     this section. I will point out any differences as we come to them.
  4291.  
  4292.  
  4293.     K  - Kill a message from paKet's PMS system
  4294.  
  4295.          (I wish other systems had used the term "Delete" or "Remove"
  4296.          rather than "Kill", but that is the accepted term for removing a
  4297.          message so I use "Kill" for the sake of conformity).
  4298.  
  4299.          A remote operator may Kill only a message sent BY that station or
  4300.          addressed TO that station, but if you are accessing the PMS
  4301.          through the Sysop PMS Menu, you have full authority.
  4302.  
  4303.          The messages are identified by number so the command must include
  4304.          the message number that is to be killed, eg:
  4305.                K 5.
  4306.  
  4307.          If possible, paKet will delete that message from the PMS Database
  4308.          and will respond with a message such as:
  4309.                Message 5 Killed
  4310.  
  4311.  
  4312.     L  - List available messages in paKet's PMS Database
  4313.  
  4314.          Upon receipt of this command paKet will send a complete listing
  4315.          of all messages currently stored in our PMS Database, showing one
  4316.          message per line.
  4317.  
  4318.          All messages in the PMS are listed here, whether the remote
  4319.          operator has access to the message or not. For example:
  4320.  
  4321.             Msg#  Size To         From       Date   Time  Subject
  4322.                2   381 VK2DHU     VK2JAW     JAN-19 14:22 Greetings
  4323.                4    59 ALL        VK2DHU     JAN-23 16:00 Good News
  4324.                7    70 VK2BZC     VK2KQX     JAN-23 19:30 forgot
  4325.                8   330 VK2KQX     VK2DHU     JAN-24 12:36 Blackout
  4326.                9   422 VK2DHU     VK2WAC     JAN-25 14:37 NVIAA
  4327.  
  4328.          Msg# is the number allocated by paKet to each message currently
  4329.               in the system.  A message will retain this number until it
  4330.               is Killed from the PMS database. Whenever the PMS is
  4331.               completely cleared of messages, paKet will restart its
  4332.               message numbers from 1.
  4333.  
  4334.          Size is the number of bytes this message occupies in the PMS
  4335.               system.
  4336.  
  4337.  
  4338.  
  4339.                                Page 160
  4340.  
  4341.          To   is the callsign of the addressee.
  4342.               This is a Personal Message System, so it is intended for
  4343.               personal messages only. Bulletins will not be accepted and
  4344.               if attempted, it will be converted to a personal message
  4345.               before being stored in the PMS database. However, a message
  4346.               may be addressed to "ALL".
  4347.  
  4348.               A remote user will be able to view only those messages which
  4349.               match that user's callsign either in the To or the From
  4350.               field, or a message addressed to ALL.
  4351.  
  4352.          From is the callsign of the station who issued the message.
  4353.  
  4354.          Date is the Computer system's date when the message was stored.
  4355.  
  4356.          Time is the Computer system's time when the message was stored.
  4357.  
  4358.          Subject is (presumably) a brief summary of the message contents?
  4359.               This is the text entered by the sender when prompted for the
  4360.               Subject.
  4361.  
  4362.  
  4363.          As this is a Personal PMS, I expect the number of messages in the
  4364.          DataBase will usually be a manageably small number. So this List
  4365.          command does not have any options to specify which message or
  4366.          range of messages you want to List. You simply specify the 'L'
  4367.          command and you get the lot!
  4368.  
  4369.          If the PMS DataBase is empty, you will get the following message:
  4370.                No messages available
  4371.  
  4372.  
  4373.     R  - Read a message from the PMS DataBase
  4374.  
  4375.          The messages are identified by number so the command must include
  4376.          the message number that is to be read, eg:
  4377.                R 5.
  4378.  
  4379.          paKet will access the PMS DataBase and locate the specified
  4380.          message. If the command came from a remote user, the contents of
  4381.          the message will be transmitted to the other station as it is
  4382.          displayed in the Communications Window. If the command came from
  4383.          the Sysop PMS Menu, the contents of the message are displayed in
  4384.          the Communications Window without transmission.
  4385.  
  4386.          If the message number specified does not exist in the PMS
  4387.          DataBase, paKet will respond with:
  4388.                I can't find that message!
  4389.  
  4390.          As mentioned above, a remote operator may Read only messages sent
  4391.          by or addressed to that station (or to ALL). If an attempt is
  4392.          made to read another message, paKet will send:
  4393.                You are not allowed access to that message
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.                                Page 161
  4402.  
  4403.     S  - Send a message to the PMS DataBase.
  4404.  
  4405.          This is the command used to enter a new message into the PMS
  4406.          DataBase.
  4407.  
  4408.          It should be noted that the message is not actually "sent"
  4409.          anywhere. It is recorded in our PMS DataBase and stays there
  4410.          until it is Killed.
  4411.  
  4412.          When the command is entered, a callsign may be specified. Eg:
  4413.                S VK2DHU
  4414.          For a remote user, the callsign is optional. If specified, the
  4415.          message will be addressed "To" that station.  If the remote user
  4416.          does not specify a callsign, paKet will address the message to you.
  4417.          (Your callsign is taken from the Configuration - Miscellaneous
  4418.          options Window).
  4419.  
  4420.          If you are "sending" a message from the Sysop PMS Menu, you don't
  4421.          have a choice - you must enter the S command with the callsign of
  4422.          the station you wish to address the message to (or ALL).
  4423.  
  4424.          When the PMS is ready to take the message it will prompt for the
  4425.          message header. Eg:
  4426.                Subject for msg 5 (max 30 characters)
  4427.  
  4428.          The message number shown is allocated by the PMS system. This
  4429.          message will retain that number until it is Killed from the
  4430.          system.
  4431.  
  4432.          The "Subject" is the text that is shown beside each message when
  4433.          a List is produced.
  4434.  
  4435.          Then, finally, the following prompt is issued:
  4436.                OK, send your message...(Ctrl-Z to end)
  4437.  
  4438.          Any text that is entered after this will be recorded in the PMS
  4439.          for this message. A <Ctrl-Z> will terminate the message. paKet
  4440.          then saves the message details in the PMS DataBase and issues the
  4441.          following confirmation that all is well:
  4442.                Message 5 stored
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.  
  4453.  
  4454.  
  4455.  
  4456.  
  4457.  
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.                                Page 162
  4464.  
  4465. Messages
  4466.  This is a list of messages relating to the PMS system. Some of these
  4467.  messages appear in the Messages section of this Manual and some appear in
  4468.  the REMOTE Mode section of this Manual. I felt it desirable to gather
  4469.  them here, despite the duplication, for your convenience.
  4470.  
  4471.  
  4472.  A disk error has occurred here. Your message is not saved.
  4473.  A disk error has occurred here - message NOT killed
  4474.  
  4475.    Either of these messages will be sent if DOS returns an error message
  4476.    when paKet is trying to update the PMS DataBase.
  4477.  
  4478.    You should investigate the cause of the error, by performing the usual
  4479.    checks for disk space, diskette door open, etc. If the operation was
  4480.    attempted by a remote operator they will have to try again when you
  4481.    have rectified the problem.
  4482.  
  4483.  
  4484.  Housekeeping...tidying up the PMS DataBase...
  4485.  
  4486.    From time to time, when you are using the Sysop PMS Menu (refer the
  4487.    <Alt-M> key) paKet will perform some internal housekeeping to minimise
  4488.    any wastage of space in the PMS sub-system. This message appears
  4489.    briefly to inform you of this housekeeping.
  4490.  
  4491.  
  4492.  I can't create a new PMS DataBase
  4493.  I'll try again next time.
  4494.  
  4495.    paKet was attempting to perform some housekeeping on the PMS database,
  4496.    removing any deleted messages to conserve space on the disk. However,
  4497.    it is unable to create a new copy of the database file. The cause could
  4498.    be something as simple as a lack of disk space.
  4499.  
  4500.    Housekeeping can wait till next time so it is a non-critical error (as
  4501.    far as the PMS is concerned anyway).
  4502.  
  4503.    This message warns you of the error but then processing continues
  4504.    normally.
  4505.  
  4506.  
  4507.  I can't find that message!
  4508.  
  4509.    The PMS command must include the message number but in this case the
  4510.    number specified does not exist in this PMS.
  4511.  
  4512.    The command should be entered with the correct message number. A List
  4513.    command ("L") will reveal the available messages.
  4514.  
  4515.  
  4516.  I can't read the message file.
  4517.  Ask (yourname) to investigate the cause
  4518.  
  4519.    Someone is trying to read a message from our PMS but paKet is unable to
  4520.    access the database for some reason.
  4521.  
  4522.    The PMS file is either missing or corrupted. If it has been corrupted
  4523.    you might have to delete it (losing any messages that were stored
  4524.    there) and allow paKet to start afresh next time it is loaded.
  4525.                                Page 163
  4526.  
  4527.  
  4528.  
  4529.  I don't handle Bulletins so I'll treat this as a Personal message.
  4530.  
  4531.    Someone has entered an "SB" command to our PMS.
  4532.  
  4533.    This is the usual way to enter a Bulletin into a BBS system, but paKet
  4534.    does not handle Bulletins. It does not perform message forwarding so
  4535.    there is little point in processing Bulletins.
  4536.  
  4537.    This message will be stored as a personal message but unless it is
  4538.    addressed to "ALL" (or a valid callsign), no-one else will be able to
  4539.    read it! Of course you have access to any message in this system.
  4540.  
  4541.  
  4542.  I have a disk error and cannot record the message.
  4543.  Ask (yourname) to investigate the cause.
  4544.  
  4545.    A disk error has occurred while paKet is attempting to write to the PMS
  4546.    files.
  4547.  
  4548.    This message will be sent to the other station who is trying to leave a
  4549.    message in our PMS.  The message has not been stored.
  4550.  
  4551.  
  4552.  Message 5 Killed
  4553.  
  4554.    Someone has killed a message from our PMS and this message is issued to
  4555.    confirm the success of the operation.
  4556.  
  4557.  
  4558.  Message 5 stored
  4559.  
  4560.    Someone has just left a message in our PMS. This message is issued by
  4561.    paKet to confirm the message has been successfully written to disk.
  4562.  
  4563.  
  4564.  Msg#  Size To         From       Date   Time  Subject
  4565.  
  4566.    This is the header line that is displayed before a List of messages to
  4567.    help identify the various fields that are displayed.
  4568.  
  4569.    This header is explained in detail in the section on Accessing the PMS
  4570.    above.
  4571.  
  4572.  
  4573.  No messages available
  4574.  
  4575.    This message will appear in response to a PMS List request if there are
  4576.    no messages currently recorded.
  4577.  
  4578.  
  4579.  Now I can't find that message
  4580.  
  4581.    Something is badly wrong if you see this message. I haven't seen it
  4582.    yet, and if YOU do, it means there is a program bug, and I'd really
  4583.    like to know exactly what you did to make it happen!
  4584.  
  4585.  
  4586.  
  4587.                                Page 164
  4588.  
  4589.  OK, send your message...(Ctrl-Z to end)
  4590.  
  4591.    When someone is leaving a message in our PMS, paKet will ask for the
  4592.    Subject of the message and then will issue this prompt to let the user
  4593.    know it is ready to accept the message and to remind that station to
  4594.    enter the <Ctrl-Z> to terminate the message.
  4595.  
  4596.  
  4597.  Please enter a Message Number with the command.
  4598.  Eg: R 4
  4599.  
  4600.    In paKet's PMS, the messages are identified by a number. When a PMS
  4601.    command is entered the system needs to know which message is to be
  4602.    processed.
  4603.  
  4604.    The command must be reentered with the message number as shown in the
  4605.    above example.
  4606.  
  4607.  
  4608.  Returning to normal communications...
  4609.  
  4610.    When you are finished with the Sysop PMS Menu and have pressed B (Bye)
  4611.    paKet closes the PMS and issues this message to confirm that operations
  4612.    are now back to normal communications mode.
  4613.  
  4614.  
  4615.  Subject for msg 5? (max 30 characters)
  4616.  
  4617.    When a message is entered into our PMS, paket will prompt the user for
  4618.    the Subject of the message. This "subject" is limited to 30 characters
  4619.    so it will fit on the line when the user displays a List of the
  4620.    available messages.
  4621.  
  4622.  
  4623.  Sysop PMS menu: <B,H,K,L,R,S,?>
  4624.  
  4625.    This is the menu that is displayed when you press <Alt-M>.
  4626.  
  4627.    Refer to the section on the Sysop PMS Menu above for full discussion.
  4628.  
  4629.  
  4630.  The PMS index is missing so all messages are lost!
  4631.  The PMS data file is missing, so all messages are lost!
  4632.  
  4633.    Either (or both) these messages could appear if either file used
  4634.    for the PMS is no longer available.
  4635.  
  4636.    It is unlikely you have had a hardware problem or some sort of disk
  4637.    failure because you would have seen a different error message if that
  4638.    had happened.
  4639.  
  4640.     This problem is more likely to be due the the files being unavailable
  4641.     for some reason. Possible reasons include:
  4642.  
  4643.      1. you have deleted them;
  4644.         If so, that's tough! You've lost any messages that might have been
  4645.         in the PMS. If the data file (PAKETPMS.DAT) alone is still there,
  4646.         you can get a fair idea of the messages by reading it though.
  4647.  
  4648.  
  4649.                                Page 165
  4650.  
  4651.      2. the Configuration file has been changed and paKet can no longer
  4652.         find the files;
  4653.         In this case, you should change the Configuration by entering
  4654.         <Alt-Z> then selecting option 8 (File/Directories) to correctly
  4655.         specify the location of the PMS files.
  4656.  
  4657.      3. The PMS files are on a diskette and that diskette is not in the
  4658.         drive.
  4659.         I don't think you need me to tell you what to do here.
  4660.  
  4661.  
  4662.  To leave a message for a particular station, enter 'S VK2XYZ'
  4663.  Note the <space> after the 'S'. Eg: S VK2XYZ
  4664.  
  4665.    Someone has entered a command beginning with S but it is not a valid
  4666.    Send command. This message is issued to help the user with the required
  4667.    syntax.
  4668.  
  4669.  
  4670.  Too many PMS messages here.
  4671.  
  4672.    I have allowed for a maximum of 200 current messages in your PMS. You
  4673.    couldn't possibly want that many, surely!
  4674.  
  4675.    Anyway, paKet can't hold any more so you will have to remove some of
  4676.    these to make room for any further messages.
  4677.  
  4678.    If the remote operator is using the PMS, the following message will
  4679.    also be sent:
  4680.          Ask (yourname) to kill some to make room
  4681.  
  4682.    If you are using the Sysop PMS Menu, the following message will be
  4683.    displayed:
  4684.          Try killing some before trying again.
  4685.  
  4686.  
  4687.  You are not allowed access to that message
  4688.  
  4689.    paKet allows a remote user to access only those messages either sent BY
  4690.    or addressed TO that station or ALL. If the REMOTE user tries to access
  4691.    someone else's message, paKet will refuse the request, returning this
  4692.    warning message.
  4693.  
  4694.  
  4695.  You have mail waiting in my PMS
  4696.  Check it out with the List and Read (and Kill) menu commands
  4697.  
  4698.    This message is sent to another station who has just connected to our
  4699.    system and paKet has found at least one message addressed to this
  4700.    station in our PMS.
  4701.  
  4702.    paKet does not note whether a message has been read, so this reminder
  4703.    will be sent every time that user connects to us if the message is not
  4704.    removed from the PMS.
  4705.  
  4706.  
  4707.  You must specify the other station's callsign.
  4708.  
  4709.    When you are entering a message into the PMS from the Sysop PMS menu
  4710.    you must enter the callsign of the station the message is intended for.
  4711.                                Page 166
  4712.  
  4713.  
  4714.    When another user is connected to our PMS, the callsign is optional
  4715.    because paKet will simply assume they are sending the message to you
  4716.    and will insert your callsign into the "To" field of the message.
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.  
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.  
  4750.  
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.  
  4758.  
  4759.  
  4760.  
  4761.  
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.                                Page 167
  4774.  
  4775.  
  4776.  
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.                        (This page intentionally blank)
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.  
  4834.  
  4835.                                Page 168
  4836.  
  4837. PART IX - CONTEST MODE
  4838.  
  4839. Overview
  4840.  
  4841.  paKet includes a Contest Mode. This has nothing whatever to do with DX
  4842.  Contest activity, but rather it is a mode designed to monitor the
  4843.  progress and results of a sporting event such as a Race or Triathlon.
  4844.  
  4845.  The scenario is one base station running paKet in Contest Mode, and one
  4846.  or more Checkpoint stations communicating contestant information to the
  4847.  Base station.
  4848.  
  4849.  Any normal Packet Radio setup will do, including any standard AX-25 TNC.
  4850.  If you can run paKet for normal communications, you should be able to run
  4851.  it in Contest Mode. The Checkpoints need not be running paKet.
  4852.  
  4853.  paKet's Contest Mode will record times for each contestant at each
  4854.  Checkpoint. At this stage, the program assumes all contestants started at
  4855.  the same time for the purpose of calculating placings. The program will
  4856.  automatically return acknowledgements to Checkpoint operators, either
  4857.  accepting the data or returning one of many self-explanatory error
  4858.  messages. The program caters for multiple pass Checkpoints where
  4859.  contestants may pass a particular Checkpoint more than once.
  4860.  
  4861.  This is a rather specialised part of paKet and it seems is rarely used. I
  4862.  was tempted to remove the code and the documentation from this version of
  4863.  paKet to help contain the ever growing size of the system.  However, it
  4864.  is there and seems to work (and there is a bit of nostalgia too because
  4865.  this Contest Mode is the very reason paKet was created in the first
  4866.  place).  But I would suggest to anyone contemplating the use of Contest
  4867.  Mode to contact me (VK2DHU @ VK2ATM.NSW.AUS.OC) before committing
  4868.  yourself to a particular event. I hope this part of the Manual will
  4869.  provide sufficient information to get you going but I'd like to know
  4870.  about your use of the system in this way and maybe I can help too?
  4871.  
  4872.  In any case, I do recommend you set up a trial "contest" with a few
  4873.  volunteers to send data as if they were real checkpoints. This way you
  4874.  will get a feel for the system and can experiment with some of the
  4875.  commands and features without the pressure that will inevitably occur on
  4876.  the Big Day.
  4877.  
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.  
  4889.  
  4890.  
  4891.  
  4892.  
  4893.  
  4894.  
  4895.  
  4896.  
  4897.                                Page 169
  4898.  
  4899. Base Operation
  4900.  
  4901.  Setting up the Checkpoint File (CKPT.DAT)
  4902.  
  4903.    A data file CKPT.DAT must be set up before the contest begins. This
  4904.    data file identifies the valid Checkpoint callsigns. The system will
  4905.    function regardless of the stream (or channel) each Checkpoint connects
  4906.    to: once the Checkpoint is connected, paKet remembers which Checkpoint
  4907.    is on which stream. The format of each CKPT.DAT record is:
  4908.  
  4909.    Checkpoint-number  <space>  Checkpoint-callsign
  4910.  
  4911.    If a Checkpoint radio operator is to process data for more than one
  4912.    Checkpoint (ie if the course brings the contestants back to this point
  4913.    so they pass that operator more than once), that callsign will appear
  4914.    in the file for each contest Checkpoint. For example, in the following
  4915.    example of the file, an operator with the callsign VK2DHU is to do a
  4916.    Checkpoint on a circuit where contestants pass three times as
  4917.    Checkpoints 2, 4 and 6:
  4918.  
  4919.     1 VK2CZZ
  4920.     2 VK2DHU
  4921.     3 VK2ABC
  4922.     4 VK2DHU
  4923.     5 VK2ABC
  4924.     6 VK2DHU
  4925.     7 VK2ABC
  4926.     8 VK2XYZ
  4927.     9 VK2BZC
  4928.     10 VK3TT
  4929.     11 VK2XXX
  4930.     12 VK2YCB
  4931.  
  4932.    If the CKPT.DAT file is not available the Contest Mode will not
  4933.    activate!
  4934.  
  4935.  
  4936.  Starting Contest Mode.
  4937.  
  4938.    To start the system, run paKet as per normal operating instructions.
  4939.    Then press <Alt-F2> to enter Contest mode. Three smaller windows appear
  4940.    in the top half of the display showing:
  4941.  
  4942.  
  4943.   ┌──Checkpoint 3──┐      ┌─Contestant 105─┐     ┌───────Placings───────┐
  4944.   │  08:15   105   │      │   1     06:35  │     │  1  120  14  16:02   │
  4945.   │  08:26   155   │      │   2     07:50  │     │  2  356  14  16:34   │
  4946.   │  08:35   183   │      │   3     08:15  │     │  3  378  14  16:39   │
  4947.   │  09:00   295   │      │   4     09:05  │     │  4  205  14  16:41   │
  4948.   │  09:00   387   │      │   5     09:57  │     │  5  375  14  16:41   │
  4949.   │  09:05   378   │      │   6     11:00  │     │  6  105  14  16:48   │
  4950.   │  09:05   194   │      │   7     12:13  │     │  7  194  14  16:48   │
  4951.   │                │      │   8     12:55  │     │  8  235  14  17:28   │
  4952.   └────────────────┘      └───Placed   6───┘     └──────────────────────┘
  4953.  ───      ────────── Window 1 - Stream A - VK2DHU ──────────────────────────
  4954.  18:59 144
  4955.  19:14 290 55
  4956.  19:07 244 142 77 105
  4957.  19:08 145
  4958.  
  4959.                                Page 170
  4960.  
  4961.    As data is received, these windows update automatically. So When
  4962.    Checkpoint number 3 is displayed, any data received from that
  4963.    Checkpoint will appear in the window. Similarly any times for the
  4964.    contestant displayed in the second window will appear there immediately
  4965.    the data is received from the Checkpoints. Placings too, update
  4966.    automatically with the leading contestants appearing at the top.
  4967.  
  4968.  
  4969.    The Base operator has the following additional commands available
  4970.    during Contest Mode operations:
  4971.  
  4972.    Alt-F4   Reload the Contest Matrix
  4973.  
  4974.             For performance reasons, the entire array of results are
  4975.             maintained in memory. So, if a power failure or system failure
  4976.             occurs, these results are lost.
  4977.  
  4978.             To provide a recovery mechanism, the Contest Matrix (which
  4979.             contains the time for each Contestant for each Checkpoint)
  4980.             will be automatically written to Hard Disk every 10 minutes
  4981.             and optionally to diskette whenever you choose to press
  4982.             <Alt-F10>.
  4983.  
  4984.             So, if a failure has occured, start Contest Mode again when
  4985.             the system becomes available and press <Alt-F4>. paKet will
  4986.             ask you for the drive which contains the Matrix. You would
  4987.             normally specify the hard Disk unless you have taken a more
  4988.             recent diskette dump with the <Alt-F10> key.
  4989.  
  4990.             The Matrix is reloaded and Contest Mode processing can
  4991.             continue from that point. You might need to ask the Checkpoint
  4992.             operators for some data to be reentered in case they had
  4993.             entered some times after the last Matrix Dump was taken. If
  4994.             they enter a time that has already been recorded they will get
  4995.             a "Duplicated" message, but no harm is done.
  4996.  
  4997.    Alt-F5   View a Checkpoint
  4998.  
  4999.             <Alt-F5> will ask which Checkpoint you want to view, then will
  5000.             display details for that Checkpoint in the Checkpoint Window
  5001.             at the top left of the screen.
  5002.  
  5003.             You will see the times and the contestant numbers of those who
  5004.             passed through the Checkpoint at those times. While viewing
  5005.             this window you may press <Up-Arrow> or <Down-Arrow> to scroll
  5006.             the data in the window.
  5007.  
  5008.             Note the border of this window will flash or change colour to
  5009.             remind you the system has stopped processing data while you
  5010.             are viewing the window. So try not to leave it in that state
  5011.             for too long. (The Checkpoint operators will not be getting
  5012.             their automatic acknowledgements while you are doing this!).
  5013.  
  5014.             Press <Esc> when finished, to allow normal data processing to
  5015.             continue.
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.                                Page 171
  5022.  
  5023.    Alt-F6   View a Contestant
  5024.  
  5025.             This is a similar function to the previous one, but of course
  5026.             operates on the second window where you may view the progress
  5027.             of a particular contestant.
  5028.  
  5029.             You will see the Checkpoint numbers and the times this
  5030.             contestant passed through those Checkpoints.
  5031.  
  5032.             Again, press <Esc> when finished viewing this window.
  5033.  
  5034.    Alt-F7   View Results
  5035.  
  5036.             The results are calculated and displayed automatically, but
  5037.             you cannot see all contestants so this function allows you to
  5038.             scroll through the entire list of contestants to view the
  5039.             up-to-date placings.
  5040.  
  5041.             You will see in the Results Window at the top right of the
  5042.             screen, the Placing, Contestant number, last Checkpoint passed
  5043.             and the time at that Checkpoint.
  5044.  
  5045.             <Esc> returns the system to normal processing.
  5046.  
  5047.    Alt-F8   Edit Results
  5048.  
  5049.             There may be occasions where the data recorded is incorrect
  5050.             and needs to be adjusted. This function allows you, the Base
  5051.             operator, full control to change any time for any contestant
  5052.             for any Checkpoint.
  5053.  
  5054.             Pressing <Alt-F8> brings up the Contestant window with a
  5055.             highlight bar (after you select the desired Contestant). Move
  5056.             the highlight bar to the Checkpoint you wish to change; press
  5057.             <Enter> for "Edit Mode"; then enter a new time (enter 00:00 to
  5058.             delete it). The system will automatically adjust placings to
  5059.             reflect the change.
  5060.  
  5061.    Alt-F9   Print the contest results
  5062.  
  5063.             This function may be selected at any time, but for a large
  5064.             contest it is recommended some form of print buffer be used.
  5065.             Normal processing will stop while the printing is done.
  5066.  
  5067.             It will not print any Checkpoints that have not yet seen ANY
  5068.             contestants.
  5069.  
  5070.    Alt-F10  Dump Contest Matrix
  5071.  
  5072.             Refer to the <Alt-F4> command above for comments on paKet's
  5073.             recovery mechanism in case of some failure during the Contest.
  5074.  
  5075.             paKet will write the Matrix to hard disk automatically every
  5076.             10 minutes but this <Alt-F10> option is a precaution that
  5077.             copies the Matrix to another file, preferably on diskette. It
  5078.             is like backup - should never be required, but...
  5079.  
  5080.             This may be used at any time during the Contest.
  5081.  
  5082.  
  5083.                                Page 172
  5084.  
  5085. Checkpoint Operation
  5086.  
  5087.    Data is sent by the Checkpoint Operators in the format:
  5088.       HH:MM nnn nnn nn nnn n nnn
  5089.    where HH:MM is the time the contestant passed that Checkpoint (the
  5090.    system will accept a ";" or a ":" character as the time separator). The
  5091.    rest of the line contains the number of each contestant who passed
  5092.    through this Checkpoint at this time. Lines must be less than 80
  5093.    columns, but experience suggests it is better to limit the number of
  5094.    contestants per line to 5 or 6.
  5095.  
  5096.    For example:
  5097.       19:07 244 142 77 105
  5098.  
  5099.    The system will perform SIMPLE data validation. If the time is not sent
  5100.    in the correct format, the entire line is assumed to be an invalid data
  5101.    line, and is treated as a comment to the Base operator. It will cause a
  5102.    beep to emanate from the Base system to alert that operator there is a
  5103.    message that possibly requires attention.
  5104.  
  5105.    A Checkpoint operator at a multi pass Checkpoint is usually too busy to
  5106.    figure out which pass a contestant is on. So, using the above CKPT.DAT
  5107.    file as an example: when a line of data is received from VK2DHU the
  5108.    system will (for each contestant on the line) look to see if any times
  5109.    have been recorded for the contestant at Checkpoint 2; if not, this
  5110.    time will be recorded. If Checkpoint 2 has been recorded, it will look
  5111.    at Checkpoint 4 and if that is empty, the time is taken to be for
  5112.    Checkpoint 4. Similarly the time will go into Checkpoint 6 if 4 was
  5113.    recorded. This is how the system caters for the multiple pass
  5114.    Checkpoints.
  5115.  
  5116.    For the simpler situations where a radio operator is sending data for a
  5117.    single Contest Checkpoint, there should not be more than one entry for
  5118.    a particular contestant. If a second entry is received, the system will
  5119.    overwrite the previous time with the new time, and will send an
  5120.    appropriate message back to the Checkpoint operator to tell him/her of
  5121.    this. Ideally, that operator can then check the paperwork there to see
  5122.    if maybe a mistake was made and it can be corrected by the Checkpoint
  5123.    operator with a further transmission as necessary.
  5124.  
  5125.    If all goes well, the Base operator should have very little to do. The
  5126.    Checkpoint operators should be able to see the acknowledgements of
  5127.    their data and they should be able to correct any of their own errors
  5128.    that show up.
  5129.  
  5130.  
  5131. Normal (non-Contest-Data) communications.
  5132.  
  5133.    The Contest Mode has not had a lot of live testing. There were two
  5134.    large Triathlons and there has been some local testing, but I am not
  5135.    entirely confident the code is as good as it could be. Until the system
  5136.    is fully proven to be sound and reliable, I prefer to keep
  5137.    non-Contest-data communications to a minimum, maybe use another packet
  5138.    station at the Base, or use voice communications. The BASE operator
  5139.    will have to manage many Communications windows simultaneously so an
  5140.    outstanding message on the Contest system could easily be missed.
  5141.  
  5142.    However, the system SHOULD allow normal chat mode even while in Contest
  5143.    Mode. Any non valid data received at the base will cause a beep to
  5144.    alert the Base operator but will otherwise cause no harm to the results
  5145.                                Page 173
  5146.  
  5147.    recorded. If a message is to be sent to a Checkpoint I like to precede
  5148.    my message with an * so the system would be sure to recognise this as a
  5149.    non-data message.
  5150.  
  5151.  
  5152. Logging the Contest activity.
  5153.  
  5154.    During processing all valid data records; details of all Connects and
  5155.    Disconnects; and any Edits (refer <Alt-F8> above) are recorded in a
  5156.    CONTEST.LOG file. This provides a full record of all Contest activity
  5157.    so may be useful to help resolve any disputes that arise.
  5158.  
  5159.    However, it is recommended that paKet's normal Disk and printer Log
  5160.    functions also be used for the duration of the Contest. The hard copy
  5161.    might prove valuable at the end of the day if there are any queries,
  5162.    especially if there were some system problems during the day.
  5163.  
  5164.  
  5165.  
  5166.  
  5167.  
  5168.  
  5169.  
  5170.  
  5171.  
  5172.  
  5173.  
  5174.  
  5175.  
  5176.  
  5177.  
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.  
  5185.  
  5186.  
  5187.  
  5188.  
  5189.  
  5190.  
  5191.  
  5192.  
  5193.  
  5194.  
  5195.  
  5196.  
  5197.  
  5198.  
  5199.  
  5200.  
  5201.  
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.                                Page 174
  5208.  
  5209. PART X - TECHNICAL
  5210. Hardware vs Software Handshaking.
  5211.  
  5212.   "Handshaking" is a technical term that refers to a method used to
  5213.   regulate the flow of data between two devices - in this case between the
  5214.   Computer and the TNC.
  5215.  
  5216.   Handshaking is required to prevent loss of data. For example, it is
  5217.   quite possible to send data to the TNC faster than the radio network can
  5218.   take it, even at low baud rates. This is OK for a while because the TNC
  5219.   has a memory buffer and the data will be held there until it can be
  5220.   transmitted. However, there is a limit to the amount of data that can be
  5221.   held in the TNC's memory, and if the computer continues to send, some
  5222.   data will be lost. So, if the TNC's buffer is filling up it will ask the
  5223.   computer (via its "Handshaking") to stop sending.
  5224.  
  5225.   The reverse could apply, where the TNC could be sending data to the
  5226.   computer faster than the computer can process it.  If you think about
  5227.   it, a baud rate of 9600 means there is only one millisecond between
  5228.   characters!  So, at that rate the computer cannot do much processing,
  5229.   especially the slower computer systems. If the computer program was
  5230.   unable to process the data quickly enough, it could use "Handshaking" to
  5231.   ask the TNC to stop sending in order to allow the computer system time
  5232.   to catch up.
  5233.  
  5234.  
  5235.   There are two forms of Handshaking, both supported by paKet:
  5236.   Hardware Handshaking and Software Handshaking.
  5237.  
  5238.  
  5239.   Hardware Handshaking:
  5240.  
  5241.   Hardware Handshaking is preferred, although it will work only if you
  5242.   have the correct cable installed. A "normal" RS-232 cable will have 9
  5243.   (or more) pins connected, some of which carry data but most of which are
  5244.   used for various forms of hardware level communication. With this
  5245.   method, the two devices (the Computer and the TNC) switch some of these
  5246.   lines on and off to tell the other whether it is OK to send more data.
  5247.  
  5248.   Should you wish to prepare a cable to use the Hardware Handshaking, the
  5249.   following table shows the connections required (connections shown for
  5250.   both a 9 pin and a 25 pin connector):
  5251.  
  5252.   DE-9   DB-25   Signal Description
  5253.    1       8     DCD Carrier Detect   Needed to enable the CONNECT check
  5254.    2       3     RXD Receive Data     Essential!
  5255.    3       2     TXD Transmit Data    Essential!
  5256.    4      20     DTR Terminal Ready   Optional
  5257.    5       7     GND Signal Ground    Essential!
  5258.    6       6     DSR Data Set Ready   Optional
  5259.    7       4     RTS Ready to Send    Needed for Hardware Handshake
  5260.    8       5     CTS Clear to Send    Needed for Hardware Handshake
  5261.    9      22     RI  Ring Indicator   Unnecessary for paKet
  5262.  
  5263.   So, a cable can be constructed using a length of six-conductor flexible
  5264.   cable (low-capacitance shielded is desirable but not essential) such as
  5265.   telephone flex with a plug on the modem end and socket on the computer
  5266.   end, wired pin-for-pin according to the above table (it may also adapt
  5267.   from DB-25 to DE-9 connector in the process).
  5268.  
  5269.                                Page 175
  5270.  
  5271.   If, say, the TNC wants to ask the Computer to stop sending, it will
  5272.   switch off the CTS signal.  The Computer (in this case, paKet) will stop
  5273.   sending data while the CTS signal is low (or off). When the TNC is able
  5274.   to accept data once again, it will switch on the CTS line and paKet will
  5275.   resume sending from where it left off. When this happens you might
  5276.   notice the CTS "light" in the Status Window come on and off as the two
  5277.   machines talk to each other.
  5278.  
  5279.   Check your TNC Manual for any special connection requirements. Most TNCs
  5280.   do not use the DTR, DSR or RI functions.
  5281.  
  5282.  
  5283.  
  5284.   Software Handshaking:
  5285.  
  5286.   Some so-called RS-232 cables have only 3 pins connected: one line for
  5287.   Receive Data, one for Transmit Data and a Signal Ground. With these
  5288.   cables, Hardware Handshaking is not possible and you must specify
  5289.   Software Handshaking.
  5290.  
  5291.   With this method, the two systems (the Computer and the TNC) must do
  5292.   their handshaking via special data codes, conventionally known as <XOFF>
  5293.   and <XON>.
  5294.  
  5295.   If, say, the TNC wants to ask the Computer to stop sending, it will send
  5296.   the <XOFF> code to the Computer.  When it is able to accept data once
  5297.   again, it will send an <XON> character.   When this happens you might
  5298.   notice in the Status Window, the words "Software Handshaking" will be
  5299.   replaced by "XOFF" temporarily, indicating we are waiting for the TNC to
  5300.   clear its buffers before it can accept some more data.
  5301.  
  5302.   On a three-wire only cable, RTS and CTS should be connected together on
  5303.   the TNC plug else the TNC may not talk to you AT ALL!
  5304.  
  5305.  
  5306.  
  5307.   Setting the chosen Handshaking method in the TNC - XFLOW:
  5308.  
  5309.   It is important to note that configuring paKet to either Hardware or
  5310.   Software Handshaking will set up the COMPUTER to use that method, but
  5311.   the TNC needs to be told too! It may not work unless both devices are
  5312.   set to use the same method.
  5313.  
  5314.   The TNC's handshaking is set with its XFLOW command:
  5315.  
  5316.      for Hardware Handshaking, set XFLOW OFF
  5317.      for Software Handshaking, set XFLOW ON.
  5318.  
  5319.   If you encounter problems with File Transfers, my experience is that the
  5320.   problem is often related to the incorrect setting of XFLOW in the TNC.
  5321.   With paKet's online configuration facility, it is easy to change from HW
  5322.   to SW mode and vice versa. To do this without changing XFLOW in the TNC
  5323.   is to invite problems.
  5324.  
  5325.   In closing this section, it should be pointed out (in case it is not
  5326.   already obvious) that if you do happen to have a full cable, you may
  5327.   choose to use either Hardware or Software Handshaking. If you choose
  5328.   Software Handshaking, the system will not use the additional
  5329.   connections. The reverse is not the case, of course. If you do not have
  5330.   a full cable, you don't have a choice!
  5331.                                Page 176
  5332.  
  5333. PREFERRED TNC SETTINGS
  5334.  
  5335.   This list of TNC settings is not a complete set of commands for your
  5336.   TNC. It is intended to be a guide to some of the preferred settings for
  5337.   use with paKet.
  5338.  
  5339.   There are some differences in some TNC commands - a command may be
  5340.   available in one TNC and not another. Or, it may be known in other TNCs
  5341.   by a different name. So, if your TNC does not have a command listed
  5342.   below, just skip that one.
  5343.  
  5344.  8BITCONV ON
  5345.           We do NOT want the top bit stripped from our data. You will see
  5346.           below we have AWLEN set to 8 so we are using all 8 data bits.
  5347.           This is especially useful if some graphics characters are being
  5348.           sent.  It does not affect Binary transfers.
  5349.  
  5350.  AWLEN    8
  5351.           Use 8 data bits so we can send all characters including graphic
  5352.           characters. You should also set PARITY to "None".
  5353.  
  5354.           paKet must be configured to the same value - refer to the
  5355.           Configuration Windows - Serial Port for details.
  5356.  
  5357.  CHCALL   OFF
  5358.           This must be OFF so we do not get the callsign of the other
  5359.           station coming through with a change of stream character. (paKet
  5360.           remembers the callsigns associated with the different streams).
  5361.  
  5362.           This, in some TNCs, is the same as the STREAMCA in others.
  5363.  
  5364.  CHDOUBLE ON
  5365.           This is optional but STRONGLY RECOMMENDED to be ON.
  5366.  
  5367.           If ON, you must set the corresponding option ON in paKet's
  5368.           Configuration Windows - Multi User options.
  5369.  
  5370.           This, in some TNCs, is the same as the STREAMDBL in others.
  5371.           If your TNC has neither CHDOUBLE nor STREAMDBL you must set
  5372.           paKet's Configuration option OFF.
  5373.  
  5374.  CHSWITCH $7C (|)
  5375.           You may set this character to any value you wish, although most
  5376.           users seem to retain the default which is the vertical bar
  5377.           character ("|").
  5378.  
  5379.           paKet must be configured to the same character (whatever you
  5380.           choose) and this is recorded in paKet's Configuration Windows -
  5381.           Multi User options.
  5382.  
  5383.           This, in some TNCs, is the same as the STREAMSW in others.
  5384.  
  5385.  CMDTIME  1 second
  5386.           Please leave this set to the default of 1 second.
  5387.  
  5388.  COMMAND  $03 (Ctrl-C)
  5389.           This must be left set to its <Ctrl-C> default setting.
  5390.  
  5391.  
  5392.  
  5393.                                Page 177
  5394.  
  5395.  CONMODE  CONVERSE
  5396.           The only time paKet must use Transparent Mode is for Binary File
  5397.           transfers, and paKet will switch automatically. So leave this
  5398.           set to CONVERSE, otherwise Stream switching will not work
  5399.           correctly.
  5400.  
  5401.  DCDCONN  ON
  5402.           If you are using Hardware Handshaking, set this ON.
  5403.  
  5404.           paKet will work either way, but the Status Display can then
  5405.           indicate with its DCD "light" whether or not you are currently
  5406.           "Connected".
  5407.  
  5408.           If set to ON, it may also be used by the paKet program to
  5409.           confirm the "Connected" status of the TNC
  5410.  
  5411.           paKet's Configuration Windows - Serial Port must also be
  5412.           configured to the same setting chosen for the TNC.
  5413.  
  5414.  ECHO     OFF
  5415.           paKet does its own echoing, so this should be OFF.
  5416.  
  5417.  FLOW     OFF
  5418.           paKet has its own Flow Control, so this should be OFF.
  5419.  
  5420.  INTFACE  BBS
  5421.           Kantronics TNCs have this command. Setting INTFACE to BBS will
  5422.           ensure we don't get unwanted messages interfering with our
  5423.           processing.
  5424.  
  5425.  MCON     OFF or 0
  5426.           You may choose to have this option ON sometimes, however it will
  5427.           interfere with REMOTE Mode and with Binary File transfers if ON
  5428.           - the system cannot distinguish the Monitored data from the
  5429.           Binary data!  paKet will turn it off before a Binary File
  5430.           transfer anyway.
  5431.  
  5432.           The preferred setting is OFF.
  5433.  
  5434.  MDIGI    OFF
  5435.           Preferred setting is OFF for the same reason as for MCON.
  5436.  
  5437.  NEWMODE  ON
  5438.           This could be either way and is a matter of personal preference.
  5439.           You may like to have NEWMODE OFF if you often work multiple
  5440.           connections because when one disconnects the TNC will revert to
  5441.           Command Mode (if NEWMODE ON) and you have to switch it back to
  5442.           Converse Mode to continue talking to the other station. In that
  5443.           case you might prefer to set NEWMODE OFF and leave the TNC in
  5444.           Converse Mode.
  5445.  
  5446.  NOMODE   OFF
  5447.           Preferred setting is OFF so the TNC will switch to Converse Mode
  5448.           when you establish a connection.
  5449.  
  5450.  
  5451.  
  5452.  
  5453.  
  5454.  
  5455.                                Page 178
  5456.  
  5457.  PARITY   0 (none)
  5458.           This is related to the Word Length (see AWLEN above) and should
  5459.           be set to "No Parity".
  5460.  
  5461.           paKet must be configured to the same value - refer to the
  5462.           Configuration Windows - Serial Port for details.
  5463.  
  5464.  PASS     $16 (Ctrl-V)
  5465.  SENDPAC  $0D (Ctrl-M)
  5466.  START    $11 (Ctrl-Q)
  5467.  STOP     $13 (Ctrl-S)
  5468.           Please leave all these set to their default values.
  5469.  
  5470.  STREAMCA OFF
  5471.           This must be OFF so we do not get the callsign of the other
  5472.           station coming through with a change of stream character. (paKet
  5473.           remembers the callsigns associated with the different streams).
  5474.  
  5475.           This, in some TNCs, is the same as the CHCALL in others.
  5476.  
  5477.  STREAMEV  OFF
  5478.           paKet does not need the stream id with every packet. This is
  5479.           required only upon change of stream - to have this on would only
  5480.           result in the transfer of unnecessary additional data.
  5481.  
  5482.  STREAMDBL ON
  5483.           This is optional but STRONGLY RECOMMENDED to be ON.
  5484.  
  5485.           If ON, you must set the corresponding option ON in paKet's
  5486.           Configuration Windows - Multi User options.
  5487.  
  5488.           This, in some TNCs, is the same as the CHDOUBLE in others.
  5489.           If your TNC has neither STREAMDBL nor CHDOUBLE you must set
  5490.           paKet's Configuration option OFF.
  5491.  
  5492.  
  5493.  STREAMSW $7C (|)
  5494.           You may set this character to any value you wish, although most
  5495.           users seem to retain the default which is the vertical bar
  5496.           character ("|").
  5497.  
  5498.           paKet must be configured to the same character (whatever you
  5499.           choose) and this is recorded in paKet's Configuration Windows -
  5500.           Multi User options.
  5501.  
  5502.           This, in some TNCs, is the same as the CHSWITCH in others.
  5503.  
  5504.  
  5505.  TRFLOW   OFF
  5506.  TXFLOW   OFF
  5507.           These commands are used for Software Handshaking in Transparent
  5508.           Mode. You should set them both OFF. paKet will switch them on
  5509.           and off if required.
  5510.  
  5511.  
  5512.  
  5513.  
  5514.  
  5515.  
  5516.  
  5517.                                Page 179
  5518.  
  5519.  USERS    n
  5520.           Although not essential, it is considered desirable to set this
  5521.           parameter to the same number of users as you have Communications
  5522.           Windows. Then you know you can have a separate window for each
  5523.           of the possible connections.
  5524.  
  5525.           If your TNC allocates a separate callsign to its PMS I suggest
  5526.           the USER parameter be set to the number of Communications
  5527.           Windows plus one.
  5528.  
  5529.  XFLOW    ON/OFF
  5530.           This parameter is important and must be set to reflect the
  5531.           chosen method of Handshaking that you have specified in paKet's
  5532.           Serial Port configuration.
  5533.  
  5534.           For Hardware Handshaking, you must have XFLOW OFF.
  5535.           For Software Handshaking, you must have XFLOW ON.
  5536.  
  5537.           Refer to the discussion of Hardware vs Software Handshaking for
  5538.           more details.
  5539.  
  5540.  XOFF     $13 (Ctrl-S)
  5541.  XON      $11 (Ctrl-Q)
  5542.           Please leave both these set to their default values.
  5543.  
  5544.  
  5545.  
  5546.  
  5547.  
  5548.  
  5549.  
  5550.  
  5551.  
  5552.  
  5553.  
  5554.  
  5555.  
  5556.  
  5557.  
  5558.  
  5559.  
  5560.  
  5561.  
  5562.  
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.  
  5569.  
  5570.  
  5571.  
  5572.  
  5573.  
  5574.  
  5575.  
  5576.  
  5577.  
  5578.  
  5579.                                Page 180
  5580.  
  5581. Kantronics TNCs
  5582.  
  5583.   My comments in this section are directed at the KAM specifically but I
  5584.   understand other models in Kantronics range operate in a similar manner
  5585.   so in many cases these comments would most likely apply to the other
  5586.   models as well.
  5587.  
  5588.   Several KAM users have written to me about problems, mainly in the area
  5589.   of Binary File transfers, with the previous version of paKet.
  5590.  
  5591.   I have only recently had access to a KAM for testing so I am still not
  5592.   confident the support for these TNCs is as good as it could be.
  5593.   Just prior to the release of paKet 5 a friend, Col VK2KQX, acquired a
  5594.   KAM and has successfully tested a Beta version of paKet 5 both for
  5595.   normal operations and for Binary File transfers.
  5596.  
  5597.   There are some notable differences in the KAM when compared to other
  5598.   TNCs, mainly in the area of Multi Stream operation, and these
  5599.   differences will have an effect on their use with paKet.
  5600.  
  5601.        *******************************************************
  5602.        I should point out at this stage, and I want to make it
  5603.        VERY CLEAR, that I like the KAM from what little I have
  5604.        seen of it. It is a very nice unit, seems to be very
  5605.        good quality and has lots of features. I have no reason
  5606.        to suspect the other models in Kantronics' range are
  5607.        anything less than first class units. I would like to
  5608.        have a KAM for myself, so please do not take these
  5609.        comments in this section as some sort of derogatory
  5610.        remarks on these TNCs.
  5611.        *******************************************************
  5612.  
  5613.   However, because of the differences I have found so far, KAM users
  5614.   should be aware of some potential operational problems.
  5615.  
  5616.   Of course there are a considerable number of enhancements in the KAM,
  5617.   supporting all those other modes such as RTTY, AMTOR, etc. I am not
  5618.   referring to those changes, but rather to the standard Packet Mode and
  5619.   the standard commands used by TAPR-compatible TNCs.
  5620.  
  5621.   paKet was written to suit the standard TAPR TNC (and compatibles) which
  5622.   was the first of the popular TNCs used in Amateur Radio. They created a
  5623.   Standard on which all modern TNCs are based.   paKet 4 is being used on
  5624.   thousands of systems around the world with a wide range on TNCs, so it
  5625.   seems the approach taken has been successful in most cases.
  5626.  
  5627.   The following differences have been noted in brief testing:
  5628.  
  5629.   1. STREAMDBL command
  5630.  
  5631.      Unfortunately the Kantronics range of TNCs do not support the
  5632.      STREAMDBL command so if you have one of those TNCs you will have to
  5633.      set paKet's STREAMDBL option OFF.
  5634.  
  5635.      STREAMDBL is a standard TNC facility to help avoid confusion where
  5636.      the STREAMSW character is received over the air as part of a data
  5637.      packet.
  5638.  
  5639.      For example, the vertical bar character ("|") that is usually used as
  5640.      the STREAMSW character is also often used as a pseudo graphic
  5641.                                Page 181
  5642.  
  5643.      character to draw vertical lines or for drawing boxes. When paKet
  5644.      receives this character from the TNC it must decide whether the TNC
  5645.      is indicating a change of stream or whether this is just another data
  5646.      character received over the radio.
  5647.  
  5648.      TNCs which support STREAMDBL can generate TWO of these vertical bar
  5649.      characters whenever one is received over the air - then paKet can
  5650.      tell the difference and there is no confusion.
  5651.  
  5652.      Without the STREAMDBL feature, you could experience some occasional
  5653.      (unexpected) changing of streams if you are monitoring the frequency
  5654.      and happen to receive a STREAMSW character (say a 'vertical bar')
  5655.      followed by some other character (say 'C'). paKet has no way of
  5656.      knowing whether the TNC is requesting a change of stream (to stream C
  5657.      in this example) or if those characters were received over the radio.
  5658.      In order to support multi stream operations, paKet has no choice but
  5659.      to assume it is a change of stream!
  5660.  
  5661.      You could minimise this problem by setting your STREAMSW to some
  5662.      obscure character that is unlikely to be received in normal
  5663.      communications. But no matter what character you choose for the
  5664.      STREAMSW you could still get ANY character combination if monitoring
  5665.      the frequency while someone else is doing a Binary File transfer and
  5666.      get what looks like a change of stream!
  5667.  
  5668.      Another anomaly was detected just prior to release when Col (my faithful
  5669.      KAM Beta tester) found responses to various commands were going into
  5670.      a different Communications Window! There has not been a lot of time
  5671.      to work on this but it seems in Command Mode, the KAM might not
  5672.      respond to a command on the same stream the command was issued. In
  5673.      any case, the symptoms are the same, where paKet and the KAM do not
  5674.      agree on what is the current Stream!
  5675.  
  5676.      I cannot change the KAM so I cannot prevent these problems from
  5677.      occurring. However I have added a new command, <Alt-I>, to help tidy
  5678.      up your display if you do happen to experience these problems on your
  5679.      system. The <Alt-I> command will initialise the Communications
  5680.      Windows, clear any backlog in the other Windows, and reset both the
  5681.      program and the TNC back to the first Stream in the first
  5682.      Communications Window.
  5683.  
  5684.      Refer to the <Alt-I> command in the Keyboard Commands section of this
  5685.      Manual for details.
  5686.  
  5687.  
  5688.   2. Dual Ports with dual STREAMSW characters.
  5689.  
  5690.      The KAM's dual port facility introduces another difficulty because
  5691.      the KAM has TWO ways of indicating a change of Stream - one for each
  5692.      port!
  5693.  
  5694.      paKet of course, currently caters for a single STREAMSW character so
  5695.      if the KAM sends the OTHER STREAMSW character, paKet will take it as
  5696.      just another data value and pass it through the system!
  5697.  
  5698.      For either VHF or HF operations, this is not a problem but if
  5699.      operating both in dual port mode, you will have to manually detect
  5700.      the change and switch to the other Window if something comes in on
  5701.      the second port.
  5702.  
  5703.                                Page 182
  5704.  
  5705.      For example say you had 4 Communications Windows configured in paKet
  5706.      and are using the first three for VHF communications and the fourth
  5707.      for HF, you would specify the VHF port's STREAMSW in paKet's Multi
  5708.      User options. Any changes of Stream between the various VHF sessions
  5709.      would work normally. If you see the HF port's STREAMSW, you would
  5710.      have to manually select that Window (eg <Shift-F4>) because paKet
  5711.      will not recognise the alternate STREAMSW character. It should
  5712.      automatically detect the normal STREAMSW and switch back to one of
  5713.      the VHF Windows when something is received on that port.
  5714.  
  5715.      This procedure has NOT been tested, so any KAM users might let me
  5716.      know how it handles the Multi Port operation and advise me of any
  5717.      special techniques you find useful.
  5718.  
  5719.      A solution to this problem would be to provide support for multiple
  5720.      STREAMSW characters in paKet but I found out about this a bit too
  5721.      late to do anything about it for this release. I hope to provide this
  5722.      support in the next release of paKet.
  5723.  
  5724.  
  5725.   3. RESET used for soft start
  5726.  
  5727.      When making changes to the TNC's Communications settings, the usual
  5728.      procedure is to issue the TNC commands to make the desired changes
  5729.      then, after making the changes to the computer's serial port the TNC
  5730.      is initialised to make the new settings effective.
  5731.  
  5732.      On most TNCs the command to re initialise is RESTART, but on the
  5733.      Kantronics units the command is RESET.   This is not a problem for
  5734.      paKet because I have added a configurable option in the Serial Port
  5735.      options to allow you to specify either RESTART or RESET. So if you
  5736.      are a Kantronics user, just specify RESET for that option and paKet
  5737.      will issue that command whenever you make any changes to the Serial
  5738.      Port parameters.
  5739.  
  5740.   If these things concern you, the only certain way to overcome them is to
  5741.   use a Host mode program supplied by Kantronics.
  5742.  
  5743.  
  5744.   With this version of paKet a TNC Help file for the Kantronics range of
  5745.   TNCs is included. It is a large file, modelled on the other TNC Help
  5746.   files and again we have Col, VK2KQX, to thank. He probably did not know
  5747.   what he was letting himself in for when he offered to set up this Help
  5748.   file, but he stuck with it and has produced this tome for the benefit of
  5749.   other Kantronics users. Thanks Col.
  5750.  
  5751.  
  5752.  
  5753.  
  5754.  
  5755.  
  5756.  
  5757.  
  5758.  
  5759.  
  5760.  
  5761.  
  5762.  
  5763.  
  5764.  
  5765.                                Page 183
  5766.  
  5767.  
  5768.  
  5769.  
  5770.  
  5771.  
  5772.  
  5773.  
  5774.  
  5775.  
  5776.  
  5777.  
  5778.  
  5779.  
  5780.  
  5781.  
  5782.  
  5783.  
  5784.  
  5785.  
  5786.  
  5787.  
  5788.  
  5789.  
  5790.  
  5791.  
  5792.  
  5793.  
  5794.  
  5795.  
  5796.  
  5797.                       (This page intentionally blank)
  5798.  
  5799.  
  5800.  
  5801.  
  5802.  
  5803.  
  5804.  
  5805.  
  5806.  
  5807.  
  5808.  
  5809.  
  5810.  
  5811.  
  5812.  
  5813.  
  5814.  
  5815.  
  5816.  
  5817.  
  5818.  
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.  
  5825.  
  5826.  
  5827.                                Page 184
  5828.  
  5829. PART XI - paKet PROTOCOL (pP)
  5830.  
  5831. What is pP ?
  5832.  
  5833.   paKet Protocol, or "pP" for short, is a YAPP-compatible Binary File
  5834.   Transfer protocol designed especially to provide a Recovery capability
  5835.   after an aborted file transfer. It is basically the YAPP Protocol with
  5836.   some additional enhancements to provide the automatic restart capability.
  5837.  
  5838.   Consider the situation where you are sending a Binary File to another
  5839.   station and the transfer is aborted for some reason, whether it be a bad
  5840.   link or power failure or any other reason. You simply send the file
  5841.   again, using the same <F7> command!  With pP, the file transfer will
  5842.   automatically start from where the previous transfer left off.
  5843.  
  5844.   pP will mostly be appreciated when you are transferring a large file and
  5845.   the transfer is aborted when almost finished. For small files, or if a
  5846.   transfer is aborted near the beginning, you might as well send the
  5847.   entire file again.
  5848.  
  5849.   pP may be used to exchange Binary Files with any other station equipped
  5850.   with either pP or YAPP protocol. The pP protocol automatically detects
  5851.   the presence of another pP station and will use the enhanced features as
  5852.   required, otherwise the standard YAPP protocol will be used.
  5853.  
  5854.   I used the YAPP Protocol Specifications published by Jeff Jacobsen
  5855.   (WA7MBL), the author of the original YAPP program, when developing this
  5856.   pP system. Extensive testing has shown pP to be fully compatible with
  5857.   YAPP Protocol.
  5858.  
  5859.   At this stage of course, pP is available only with paKet version 5.
  5860.   However, the paKet Protocol details are offered to the Public Domain and
  5861.   are discussed in some detail below. I will be happy to assist developers
  5862.   of other YAPP Protocol software with the pP enhancements so they too can
  5863.   offer this feature in their software.
  5864.  
  5865.   But please note, I am offering to discuss the pP *ENHANCEMENTS* to
  5866.   *EXISTING* YAPP Protocol programs. Please don't call me for assistance
  5867.   with the development/debugging of Standard YAPP Protocol software!
  5868.  
  5869.   In the sections that follow, I give some examples of the exchange of
  5870.   dialog between the two stations. For convenience here, I will refer to
  5871.   the two sides as the Sender and the Receiver. So, if I use the term
  5872.   "Sender" or "Receiver" I might be referring to the operator or to the
  5873.   software or to the system generally, but I am sure you will get the idea.
  5874.  
  5875.   I hope Jeff Jacobsen will forgive me if I suggest his original YAPP
  5876.   program has now been superseded but his YAPP Protocol lives on as the
  5877.   current Standard for Binary File transfers in the world of Packet Radio.
  5878.   In the following sections, when I refer to "YAPP", I am referring to the
  5879.   YAPP Binary File Transfer Protocol, not to the original YAPP program
  5880.   that started it all.
  5881.  
  5882.  
  5883.  
  5884.  
  5885.  
  5886.  
  5887.  
  5888.  
  5889.                                Page 185
  5890.  
  5891. Using pP
  5892.  
  5893.   For most Binary File transfers, pP will behave in a similar manner to
  5894.   YAPP and the performance will be the same.
  5895.  
  5896.   No special action is required to use pP.  Using pP is the same as using
  5897.   YAPP so if you have been using an earlier version of paKet, the
  5898.   procedure to send or receive a Binary File is the same.
  5899.  
  5900.   Refer to the <F7> and <F8> keys in the "Keyboard Commands" section of
  5901.   this Manual for operation details.
  5902.  
  5903.  
  5904.  Typical scenario:
  5905.  
  5906.   Say you are sending a Binary File to another pP station. You send the
  5907.   file in the usual way, starting with the <F7> key.
  5908.  
  5909.   The transfer begins just like any other Binary File transfer starting
  5910.   from the beginning of the file.
  5911.  
  5912.   Then part way through, let's say after sending half the file, something
  5913.   goes wrong. Ummm, for this illustration we'll say the digipeater we were
  5914.   using goes off the air and we lose the link with the other station.
  5915.  
  5916.   So, call up using a different path and establish communications with
  5917.   that station again.  Then start the same file transfer again, using the
  5918.   same <F7> key again, specifying the same filename again. Come to think
  5919.   of it, this is what you would do anyway, isn't it? Whether using pP or
  5920.   not! But with most other protocols, the entire file would be resent from
  5921.   the beginning. With pP, a Recovery is possible.
  5922.  
  5923.   When the file transfer is started, the following activity takes place
  5924.   (assuming both stations support pP):
  5925.  
  5926.      1. The exchange of pP/YAPP initialisation codes verifies each station
  5927.         is ready to start the transfer (standard YAPP Protocol).
  5928.  
  5929.      2. The Sender sends the Protocol header, which includes the file name
  5930.         and file size (standard YAPP protocol). The header also includes a
  5931.         new field to identify this station as a pP station.
  5932.  
  5933.      3. The Receiver detects that this file already exists on that system
  5934.         and is smaller than the one about to be received. (The file is
  5935.         smaller because it is only half there!)
  5936.  
  5937.         The Receiver now knows that the Sender is a pP station because of
  5938.         the additional field in the header.
  5939.  
  5940.      4. The Receiver requests a pP recovery and sends some details of its
  5941.         (shorter) file.
  5942.  
  5943.      5. The Sender checks those details against the file about to be sent.
  5944.         It looks like the same file, so the Sender issues an approval then
  5945.         starts sending from the agreed point in the file.
  5946.  
  5947.         (If the Sender decides it does not look like the same file, the
  5948.         Recovery request would be denied and the transfer would start from
  5949.         the beginning).
  5950.  
  5951.                                Page 186
  5952.  
  5953.      6. When the Receiver gets the Recovery approval, that system will
  5954.         reset the file pointers and will start writing any data received
  5955.         at the agreed starting point in the file, effectively appending to
  5956.         the existing file.
  5957.  
  5958.      7. The transfer then continues from that point using standard YAPP
  5959.         Protocol.
  5960.  
  5961.   While all this is going on, you do nothing - just watch the messages
  5962.   informing you of the exchange of pP dialogue as outlined above. Then
  5963.   when the Binary File Transfer Window appears you will see the file
  5964.   transfer is already partly completed! It has picked up almost from where
  5965.   it left off.
  5966.  
  5967.  
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.  
  5980.  
  5981.  
  5982.  
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.  
  5989.  
  5990.  
  5991.  
  5992.  
  5993.  
  5994.  
  5995.  
  5996.  
  5997.  
  5998.  
  5999.  
  6000.  
  6001.  
  6002.  
  6003.  
  6004.  
  6005.  
  6006.  
  6007.  
  6008.  
  6009.  
  6010.  
  6011.  
  6012.  
  6013.                                Page 187
  6014.  
  6015. The technical details of the paKet Protocol:
  6016.  
  6017.   For this discussion I will be referring to some of Jeff Jacobsen's YAPP
  6018.   Specifications. If you are a developer of YAPP compatible software, you
  6019.   will already know about these things. If you are an interested user and
  6020.   do not have these specifications handy, I will try to explain as I go.
  6021.  
  6022.   A warning though... this section does get a bit heavy and is included
  6023.   for the technically minded. If you find you are having trouble
  6024.   understanding it, just skip to another section - it is NOT necessary to
  6025.   understand all this in order to use pP.
  6026.  
  6027.  
  6028. Sender   - Sending a pP/YAPP Header
  6029.  
  6030.   The YAPP Header is listed in the YAPP specifications as follows:
  6031.   HD    Send_Hdr
  6032.   <SOH> <len> (Filename) <NUL> (File Size in ASCII) <NUL> (Opt)
  6033.  
  6034.   This header is sent at the beginning of the transfer to identify the
  6035.   name and size of the file about to be sent. Note there is an optional
  6036.   field provided, and it is this optional field that pP uses to identify
  6037.   the Sender as a pP station.
  6038.  
  6039.   When the Sender sends a file header, the "optional" field will contain
  6040.   the pP Identifier string, "paKet-Protocol" (without the quotes).
  6041.  
  6042.   So if we were sending a file "PROG.EXE" and that file was 74692 bytes
  6043.   long, the pP header might look like:
  6044.      <SOH><29>PROG.EXE<NUL>74692<NUL>paKet-Protocol
  6045.   (I use the "< >" combination to indicate single byte values).
  6046.  
  6047.   This optional field should be sent with every Header. If the Receiver is
  6048.   running Standard YAPP Protocol it will not get upset because the
  6049.   optional field is provided for in the Specifications. Testing with
  6050.   various YAPP Protocol systems has shown this works without problems,
  6051.   however should some system somewhere object to this optional field being
  6052.   used in this way, the paKet user can switch off the pP option in the
  6053.   Configuration - File Transfer options. In that case the Sender would not
  6054.   send the optional field and the Receiver will think we are running
  6055.   Standard YAPP Protocol!
  6056.  
  6057.  
  6058. Receiver - Receiving a pP/YAPP Header and requesting Recovery
  6059.  
  6060.   When the Header is received, the Receiver will check the Header's file
  6061.   details. If that file does not yet exist it will create a new file, send
  6062.   an <ACK> to the Sender and continue with the transfer using Standard
  6063.   YAPP Protocol.
  6064.  
  6065.   If a file of the same name already exists on the Receiver system it
  6066.   could be just another version of the same file or maybe it is the result
  6067.   of an earlier transfer attempt that was not completed. If it is a partly
  6068.   completed copy of an earlier transfer attempt, pP can identify this and
  6069.   perform a Recovery. If it is not that same file, pP can recognise this
  6070.   too and revert to Standard YAPP Protocol for a "normal" transfer of the
  6071.   entire file.
  6072.  
  6073.  
  6074.  
  6075.                                Page 188
  6076.  
  6077.   The Receiver will request a pP Recovery if the following conditions are
  6078.   ALL met:
  6079.  
  6080.       1. a file already exists with the same file name;
  6081.                               and
  6082.       2. The size of the existing file is greater than 1000 bytes;
  6083.                               and
  6084.       3. The file size is smaller than that in the Header just received;
  6085.                               and
  6086.       4. the Header contains the "paKet-Protocol" identifier;
  6087.                               and
  6088.       5. the user of this Receiver system has indicated in the
  6089.          Configuration that pP may be used.
  6090.          (This is implemented in paKet but is an optional feature of the
  6091.          pP Protocol).
  6092.  
  6093.  
  6094.   Let's discuss briefly each of these requirements.
  6095.  
  6096.   1. If the file does not yet exist, there is no need for Recovery and a
  6097.      standard YAPP Protocol transfer will take place.
  6098.  
  6099.   2. You will see later that a Recovery does not actually begin from the
  6100.      end of this short file, but begins 750 bytes back from the end. If
  6101.      the Receiver's file is shorter than 1000 bytes, it is hardly worth a
  6102.      Recovery anyway!  We might just as well start again from the
  6103.      beginning.
  6104.  
  6105.   3. If the Receiver's file is already bigger than the one about to be
  6106.      sent, it is certainly NOT the result of an aborted transfer of this
  6107.      same file!
  6108.  
  6109.   4. If the Header does not contain the pP identifier, the Sender is not
  6110.      running pP. There is no point in asking a non-pP system for a
  6111.      Recovery!
  6112.  
  6113.   5. The paKet user may disable the pP facility, so the ultimate control
  6114.      remains with the user. This option is provided in paKet but is not a
  6115.      requirement of the Protocol. Another program that supports pP might
  6116.      not provide this user option.
  6117.  
  6118.   If all the above conditions are met and the Receiver decides to request
  6119.   a Recovery, a "NP" record is prepared and sent to the Sender. This NP
  6120.   record is defined below:
  6121.  
  6122.  
  6123.  NP record.
  6124.  
  6125.   The YAPP Specifications include an NR record for a negative
  6126.   acknowledgement ("Not Ready" sometimes referred to as NAK). The standard
  6127.   NR record provides for the <NAK> code followed by an optional "reason"
  6128.   in ASCII.
  6129.  
  6130.   Using this format with the optional field to maintain compatibility
  6131.   with the Standard YAPP Protocol, I have created a new Protocol record
  6132.   and I called it NP. This new record is:
  6133.  
  6134.  
  6135.  
  6136.  
  6137.                                Page 189
  6138.  
  6139.   NP    pP Recovery request
  6140.   <NAK><len>paKet-Protocol,(length of file),(first 100 bytes)(last 100 bytes)
  6141.  
  6142.   - The <NAK> is the ASCII code with a value of 21;
  6143.  
  6144.   - <len> is the length of the following data;
  6145.  
  6146.   - The pP identifier string "paKet-Protocol" comes next (14 bytes).
  6147.     This is the optional "reason" provided for in the YAPP Specifications!;
  6148.  
  6149.   - The length of the file is actually the length of the file on the
  6150.     Receiver's system LESS 850 bytes. (Further discussion on this below)
  6151.  
  6152.     The value is sent as ASCII characters and please note there are commas
  6153.     before and after these numbers.
  6154.  
  6155.     So, if the file on the Receiver's system is 53,964 bytes, this field
  6156.     would contain the following seven ASCII characters:
  6157.        ,53114,
  6158.  
  6159.   - The first 100 bytes of the short file on the Receiver system;
  6160.  
  6161.   - The "last" 100 bytes of the short file on the Receiver system.
  6162.  
  6163.   To get the "last" 100 bytes the Receiver system will move to a position
  6164.   850 bytes back from the end of the file and read the next 100 bytes
  6165.   from there. So the last 750 bytes will be ignored and if a Recovery is
  6166.   successful, those 750 bytes will be overwritten.
  6167.  
  6168.   This figure of 850 bytes is somewhat arbitrary. I felt it was necessary
  6169.   to provide SOME overlap to cover the situation where the end of the
  6170.   short file might be corrupted (it WAS aborted for some reason, don't
  6171.   forget!). If you are developing your own pP system, feel free to choose
  6172.   another figure - this affects only the Receiver, so your system can
  6173.   still perform a Recovery from paKet (or any other pP system). I would
  6174.   suggest a larger rather than a shorter figure should be chosen if you
  6175.   wish to change it. You might like to reduce the overlap to save time on
  6176.   duplicating the data already sent, but keep in mind it takes only a
  6177.   second or two to send 100 bytes and the Recovery could save many
  6178.   minutes, maybe an hour! I don't think the user will get upset if it
  6179.   takes a few seconds to Recover.
  6180.  
  6181.   So, as an example, an NP record might look like:
  6182.      <NAK><221>paKet-Protocol,53114,........
  6183.   (the dots represent the 200 data bytes).
  6184.  
  6185.  
  6186. Sender   - Processing a Recovery request (NP record) from the Receiver
  6187.  
  6188.   After sending the Header, the Sender would usually get an RF packet
  6189.   indicating the other station is now ready to "Receive the File". In that
  6190.   case the entire file is sent from the beginning in accordance with the
  6191.   Standard YAPP Protocol.
  6192.  
  6193.   If the Sender gets the NP packet, it means the other station is
  6194.   requesting a pP Recovery. It could be they already have part of this
  6195.   file so it is now up to the Sender to decide whether it is or is not the
  6196.   same file. Of course the only way to be really sure about this is to
  6197.   compare the entire file but if we are going to do this we might as well
  6198.   send the whole thing again!
  6199.                                Page 190
  6200.  
  6201.  
  6202.   I decided it is a reasonable risk to compare the first 100 bytes of the
  6203.   two files, then to compare the last 100 bytes of the files. (The "last"
  6204.   100 bytes in this case would be somewhere in the middle of the Sender's
  6205.   file.) If these 200 bytes match - same values at the same locations and
  6206.   the two files have the same name, then pP will accept they ARE the same
  6207.   file and the Recovery will be approved.
  6208.  
  6209.   The NP packet includes the size of the file on the Receiver's system,
  6210.   the first 100 bytes plus the last 100 bytes of that file. So the Sender
  6211.   system will access the file about to be sent and will compare the first
  6212.   100 bytes. If they are all the same, it will move down the file to the
  6213.   location corresponding to the file size given in the NP record. If the
  6214.   next 100 bytes in the file also match those given in the NP record, a
  6215.   Recovery will be approved.
  6216.  
  6217.   If even one byte does not match, the Recovery will be denied.
  6218.  
  6219.   So, if the Sender approves the Recovery, it will send the "Approval for
  6220.   Recovery" packet, the "AP" record, which is a new Protocol record and
  6221.   consists of two bytes:
  6222.      <ACK><6>
  6223.   Then it will position the file pointer to the file size given by the NP
  6224.   record plus 100 bytes. (Those "last" 100 bytes have been matched so
  6225.   there's no need to send them again.)  And the file transfer continues
  6226.   from that point using Standard YAPP Protocol.
  6227.  
  6228.   If the Sender denies the Recovery, it will send the "Recovery Denied"
  6229.   packet, the "DN" record. This too, is a new Protocol record and consists
  6230.   of 16 bytes to distinguish it from an "ordinary" NAK:
  6231.      <NAK><14>paKet-Protocol
  6232.   As the Recovery has been denied, the file will be sent in its entirety
  6233.   and the transfer will proceed using Standard YAPP Protocol, starting
  6234.   from the beginning of the file.
  6235.  
  6236.  
  6237. Receiver - Processing Response to Recovery request.
  6238.  
  6239.   This is the final stage of the Recovery process. The Receiver had
  6240.   requested a Recovery and now will find out whether the Recovery is
  6241.   approved or denied. The Receiver will get either an Approval (AP record)
  6242.   or a Denial (DN record). Details of these records are shown in the
  6243.   previous section.
  6244.  
  6245.   If the Recovery is approved, the Receiver will adjust the file pointer
  6246.   to the file size less 750 bytes.
  6247.  
  6248.   Yes, that's right 750! We moved back 850 bytes into the file to include
  6249.   the "last" 100 bytes in the the NP record. Now that we have an approval,
  6250.   we know those "last" 100 bytes are OK so there's no need to transfer
  6251.   them again. We will start receiving data from AFTER those "last" 100
  6252.   bytes, overwriting the last 750 bytes in the file.  (See comments above
  6253.   under "NP Record" - you may vary this "setback" figure of 850 bytes if
  6254.   you are developing your own pP software).
  6255.  
  6256.  
  6257.   If Recovery is denied, the entire file will be sent so the Receiver will
  6258.   either have to overwrite the existing file or create a new one.
  6259.  
  6260.  
  6261.                                Page 191
  6262.  
  6263.   I would like to point out here that if the paKet program is receiving a
  6264.   file and Recovery is denied, the existing (short) file will be preserved
  6265.   and a new file with a different extension (eg: .000 or .001 etc) will be
  6266.   created. This is a feature of the paKet program NOT part of the pP file
  6267.   transfer Protocol.  pP just manages the Recovery process. So if some
  6268.   other program uses pP it might handle "Recovery Denied" differently by
  6269.   simply producing an error message such as "File Exists" or it might
  6270.   overwrite the existing short file.
  6271.  
  6272.  
  6273.  
  6274.  
  6275.  
  6276.  
  6277.  
  6278.  
  6279.  
  6280.  
  6281.  
  6282.  
  6283.  
  6284.  
  6285.  
  6286.  
  6287.  
  6288.  
  6289.  
  6290.  
  6291.  
  6292.  
  6293.  
  6294.  
  6295.  
  6296.  
  6297.  
  6298.  
  6299.  
  6300.  
  6301.  
  6302.  
  6303.  
  6304.  
  6305.  
  6306.  
  6307.  
  6308.  
  6309.  
  6310.  
  6311.  
  6312.  
  6313.  
  6314.  
  6315.  
  6316.  
  6317.  
  6318.  
  6319.  
  6320.  
  6321.  
  6322.  
  6323.                                Page 192
  6324.  
  6325. PART XII - ADMINISTRATION DETAIL
  6326.  
  6327. The cost of paKet.
  6328.  paKet is offered to the world as a Shareware product for $25 (Aust) per
  6329.  copy. If you would like me to mail a copy to you, an additional $5 covers
  6330.  the cost of a diskette, postage, and packaging.
  6331.  
  6332.  For those who are unfamiliar with Shareware, let me explain briefly: A
  6333.  Shareware product is one which may be copied freely and distributed to
  6334.  others for evaluation. However, if anyone decides to keep and use the
  6335.  program, the prescribed payment must be paid. It is not a Public Domain
  6336.  program.
  6337.  
  6338.  As with most other software products, it is likely there will be many
  6339.  people who take it and use it illegally, but with Shareware distribution
  6340.  it is possible to keep the cost down to a minimum, cutting out the middle
  6341.  men and the costly distribution channels. An equivalent (or lesser!)
  6342.  commercial product might cost hundreds more because of these overheads. I
  6343.  think you will agree, $25 is not an exorbitant price for the "best Packet
  6344.  Radio software in the world".
  6345.  
  6346.  
  6347.  I hope you are honest enough to pay the $25 if you use paKet.
  6348.  
  6349.  
  6350.  You can charge the $25 to your Visa, Mastercard or Australian Bankcard.
  6351.  Or if you prefer you could send a Money Order or a cheque (that's "check"
  6352.  if you're American). Please send the following Registration Form with
  6353.  your details.
  6354.  
  6355.  
  6356.  When you register for paKet, you are registered for life! I will be happy
  6357.  to send you any updates as they become available, provided I can cover my
  6358.  costs. So if you would like the next update, send me $5 (or equivalent in
  6359.  your currency) to cover the cost of a diskette, mailer box, postage,
  6360.  etc.  Perhaps you should wait until a new version is announced before
  6361.  sending your $5 because I am not sure how many more versions there will
  6362.  be!
  6363.  
  6364.  Please let me know what you think of paKet and let me know if you have
  6365.  any ideas for improvement. While I cannot promise to incorporate all
  6366.  suggestions, your opinions and ideas are welcomed. Of course I would also
  6367.  like to know if you detect any .. er .. bugs .. in the system.
  6368.  
  6369.  
  6370.  
  6371.  
  6372.  
  6373.  
  6374.  
  6375.  
  6376.  
  6377.  
  6378.  
  6379.  
  6380.  
  6381.  
  6382.  
  6383.  
  6384.  
  6385.                                Page 193
  6386.  
  6387. Acknowledgements and Credits
  6388.  
  6389.  I would like to acknowledge here the help, enthusiasm, encouragement and
  6390.  support I received from a large number of paKet users, especially the
  6391.  local Packet/paKet users who have inspired me to continue developing
  6392.  paKet.
  6393.  
  6394.  Paul VK2BZC, has been and continues to be a powerful force in the
  6395.  development of the paKet system. He has a rare blend of expertise,
  6396.  intelligence and ideas. This, combined with an enthusiasm for paKet that
  6397.  must come close to matching my own, has resulted in a continual flow of
  6398.  critical comment that has proved to be of enormous benefit to the
  6399.  finished product. Thanks Paul.
  6400.  
  6401.  Col VK2KQX, the poor unsuspecting fellow who mentioned to me that he had
  6402.  bought a KAM. Since then Col has done a lot of testing with the Beta
  6403.  version of paKet 5 proving the Binary Transfer system, firstly with his
  6404.  BayCom system then with the KAM after he upgraded. Col also provided his
  6405.  professional expertise in getting the diskette labels and mailer boxes
  6406.  prepared and printed, going way beyond any reasonable call of duty. If
  6407.  that was not enough, he also volunteered to prepare the TNC Help File for
  6408.  the Kantronics range of TNCs, a mammoth task that I am sure will be
  6409.  appreciated by all users of these TNCs.
  6410.  
  6411.  And the list goes on ... Daryl VK2DAZ, provided lots of help, advice and
  6412.  testing with paKet's Script processing; Arthur VK2ATM, for help with Beta
  6413.  testing and for making his system available for our local BBS; Bill
  6414.  VK2ZCV, a devoted Digicom then BayCom user, for help with testing the
  6415.  Digicom and BayCom file transfers.
  6416.  
  6417.  A special mention of thanks is due to Chris Edmondson VK3YID, editor of
  6418.  the Amateur Radio Action magazine for a most complimentary review of
  6419.  PAKET 4 and for carrying a classified advertisement for paKet, month
  6420.  after month.
  6421.  
  6422.  And there are the literally hundreds of paKet users who have written with
  6423.  support, advice, suggestions and encouragement. A large number of the
  6424.  improvements in this version of paKet have come from the paKet community.
  6425.  
  6426.  
  6427.  Although so many people have contributed so much, I want to emphasise
  6428.  that any problems you have with paKet are my fault because I did the
  6429.  programming.
  6430.  
  6431.  
  6432.  
  6433.  
  6434.  
  6435.  
  6436.  
  6437.  
  6438.  
  6439.  
  6440.  
  6441.  
  6442.  
  6443.  
  6444.  
  6445.  
  6446.  
  6447.                                Page 194
  6448.  
  6449. Where to find the author
  6450.  
  6451.  All packet radio communications can be sent via the Packet Network to me,
  6452.  Tony VK2DHU @ VK2ATM.NSW.AUS.OC. When you "write", please tell me which
  6453.  version of paKet you are using and the type of TNC you have. I reply to
  6454.  ALL mail but on several occasions I have discovered (upon investigating
  6455.  queries) that mail sent to me via Packet Radio has not arrived. If you do
  6456.  not get a reply, please send a follow up note.
  6457.  
  6458.  All mail communications, including the $25, may be sent as follows:
  6459.  
  6460.          M. A. Lonsdale,
  6461.          VK2DHU,
  6462.          6 Marsden Cres,
  6463.          Port Macquarie 2444
  6464.          Australia
  6465.  
  6466.  I am NOT on the phone (if you get my drift).
  6467.  
  6468.  Please use and enjoy paKet, and if you give a copy to your friends,
  6469.  please give them all the original files to ensure they get the full
  6470.  paKet system.
  6471.  
  6472.  And don't forget to let me know of your experiences with paKet.
  6473.  
  6474.  73s
  6475.  
  6476.  de Tony VK2DHU
  6477.  
  6478.  
  6479.  
  6480.  
  6481.  
  6482.  
  6483.  
  6484.  
  6485.  
  6486.  
  6487.  
  6488.  
  6489.  
  6490.  
  6491.  
  6492.  
  6493.  
  6494.  
  6495.  
  6496.  
  6497.  
  6498.  
  6499.  
  6500.  
  6501.  
  6502.  
  6503.  
  6504.  
  6505.  
  6506.  
  6507.  
  6508.  
  6509.                                Page 195
  6510.  
  6511. REGISTRATION FORM
  6512.                                paKet version 5.0
  6513.  
  6514.   Name___________________________________________________________________
  6515.  
  6516.   Call Sign_____________________Home BBS for Packet Mail_________________
  6517.  
  6518.   Address________________________________________________________________
  6519.  
  6520.          ________________________________________________________________
  6521.  
  6522.   Type of TNC____________________________________________________________
  6523.  
  6524.   Diskette Type:    360KB [ ]    1.2MB [ ]     720KB [ ]   1.44MB [ ]
  6525.                            (5.25 inch)                (3.5 inch)
  6526.  
  6527.   Where did you get paKet (optional)?
  6528.  
  6529.   BBS?    _______________________________________________________________
  6530.  
  6531.   Friend? _______________________________________________________________
  6532.  
  6533.  
  6534.   Comments_______________________________________________________________
  6535.  
  6536.   _______________________________________________________________________
  6537.  
  6538.   _______________________________________________________________________
  6539.  
  6540.   _______________________________________________________________________
  6541.  
  6542.   _______________________________________________________________________
  6543.  
  6544.   _______________________________________________________________________
  6545.  
  6546.   _______________________________________________________________________
  6547.  
  6548.   _______________________________________________________________________
  6549.  
  6550.   _______________________________________________________________________
  6551.  
  6552.   _______________________________________________________________________
  6553.  
  6554.   _______________________________________________________________________
  6555.  
  6556.  
  6557.   -----------------------------------------------------------------------
  6558.   Make cheques (checks) payable to:
  6559.   M. A. Lonsdale
  6560.  
  6561.   Address:
  6562.   6 Marsden Crescent, Port Macquarie, NSW 2444, Australia
  6563.   -----------------------------------------------------------------------
  6564.  
  6565.   Payment:(mark or circle one):
  6566.        [ ] Cheque      [ ] Money Order      [ ] Cash
  6567.        [ ] Visa        [ ] MasterCard       [ ] Bankcard
  6568.  
  6569.    Credit Card #_________________________________________Amount $A_______
  6570.  
  6571.    Expiry Date___________________Signature ______________________________
  6572.  
  6573.